KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT
KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 属性为 DMA 驱动的事件通知注册用户模式事件。 成功调用 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 后，必须注册事件。
下表总结了此属性的功能。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
是 |
固定 |
NULL |
属性描述符（实例数据）由包含 KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY 结构组成，该结构包含 KSPROPERTY 结构以及用户模式事件句柄。
此属性的属性值（操作数据）为 NULL，因为未返回任何操作数据。
返回值
KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT 属性请求返回 STATUS_SUCCESS，以指示已成功完成。 否则，请求将返回适当的故障状态代码。 下表显示了一些可能的故障状态代码。
| 状态代码 | 含义 |
|---|---|
STATUS_NOT_SUPPORTED |
不支持事件通知。 |
STATUS_INSUFFICIENT_RESOURCES |
无法为缓冲区分配内存。 |
STATUS_DEVICE_NOT_READY |
设备未准备就绪。 |
注解
此属性用于注册 DMA 驱动的事件通知的用户模式事件。
当引脚被置于运行状态 (KSSTATE_RUN) 时，根据调用 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 时请求的通知计数，已注册事件在循环音频缓冲区的每个循环中被发送一到两次信号。 有关 KSSTATERUN 的详细信息，请参阅状态转换主题。
停止引脚后，在关闭引脚之前，每个已注册的事件都会通过调用 KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT 来取消注册。
要求
版本 |
适用于 Windows Vista 及更高版本的 Windows 操作系统。 |
标头 |
Ksmedia.h |
另请参阅
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION