KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 属性为 DMA 驱动的事件通知注册用户模式事件。成功调用 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 后，必须注册事件。

下表总结了此属性的功能。

获取	设置	目标	属性描述符类型	属性值类型
是	是	固定	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	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