设备事件通知客户端系统中 音频终结点设备 状态发生更改。 下面是设备事件的示例：

添加或删除音频适配器会为所有连接到该适配器的音频终结点设备生成设备事件。 上述列表中的前四项是设备状态更改的示例。 有关音频终结点设备的设备状态的详细信息，请参阅 DEVICE_STATE_XXX常量。 有关插孔状态检测的详细信息，请参阅 音频终结点设备。

客户端可以注册，以在发生设备事件时收到通知。 为了响应这些通知，客户端可以动态更改其使用特定设备的方式，或选择要用于特定用途的不同设备。

例如，如果应用程序正在通过一组 USB 扬声器播放音轨，并且用户断开了扬声器与 USB 连接器的连接，则应用程序会收到设备事件通知。 为响应事件，如果应用程序检测到一组桌面扬声器已连接到系统主板上的集成音频适配器，则应用程序可以通过桌面扬声器继续播放音轨。 在此示例中，从 USB 扬声器到桌面扬声器的转换会自动进行，而无需用户通过显式重定向应用程序进行干预。

为了注册以接收设备通知，客户端调用 IMMDeviceEnumerator：：RegisterEndpointNotificationCallback 方法。 当客户端不再需要通知时，它会通过调用 IMMDeviceEnumerator：：UnregisterEndpointNotificationCallback 方法取消通知。 这两种方法都采用名为 pClient 的输入参数，该参数是指向 IMMNotificationClient 接口实例的指针。

IMMNotificationClient 接口由客户端实现。 接口包含多个方法，每种方法都用作特定类型的设备事件的回调例程。 当音频终结点设备中发生设备事件时，MMDevice 模块在当前注册的每个客户端的 IMMNotificationClient 接口中调用相应的方法，以接收设备事件通知。 这些调用将事件的说明传递给客户端。 有关详细信息，请参阅 IMMNotificationClient 接口。

注册为接收设备事件通知的客户端将接收系统中所有音频终结点设备中发生的所有类型的设备事件的通知。 如果客户端只对某些事件类型或某些设备感兴趣，则其 IMMNotificationClient 实现中的方法应相应地筛选事件。

Windows SDK 提供的示例包括 IMMNotificationClient 接口的多个实现。 有关详细信息，请参阅 使用核心音频 API 的 SDK 示例。

下面的代码示例演示 IMMNotificationClient 接口的可能实现：

上述代码示例中的 CMMNotificationClient 类是 IMMNotificationClient 接口的实现。 由于 IMMNotificationClient 继承自 IUnknown，因此类定义包含 IUnknown 方法 AddRef、 Release 和 QueryInterface 的实现。 类定义中的其余公共方法特定于 IMMNotificationClient 接口。 这些方法包括：

其中每种方法都采用一个输入参数 pwstrDeviceId，它是指向终结点 ID 字符串的指针。 字符串标识发生设备事件的音频终结点设备。

在前面的代码示例中，_PrintDeviceName 是 CMMNotificationClient 类中的一个私有方法，用于打印设备的友好名称。 _PrintDeviceName采用终结点 ID 字符串作为输入参数。 它将字符串传递给 IMMDeviceEnumerator：：GetDevice 方法。 GetDevice 创建一个终结点设备对象来表示设备，并为该对象提供 IMMDevice 接口。 接下来，_PrintDeviceName调用 IMMDevice：：OpenPropertyStore 方法以检索设备属性存储的 IPropertyStore 接口。 最后，_PrintDeviceName调用 IPropertyStore：：GetItem 方法以获取设备的友好名称属性。 有关 IPropertyStore 的详细信息，请参阅 Windows SDK 文档。

除了设备事件，客户端还可以注册以接收音频会话事件和终结点卷事件的通知。 有关详细信息，请参阅 IAudioSessionEvents 接口 和 IAudioEndpointVolumeCallback 接口。

音频终结点设备