KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

La propiedad KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT registra un evento en modo de usuario para la notificación de eventos controlada por DMA. Los eventos deben registrarse después de llamar correctamente a KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

En la tabla siguiente se resumen las características de esta propiedad.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	Sí	Anclar	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

El descriptor de propiedad (datos de instancia) consta de una estructura de KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY que contiene una estructura KSPROPERTY junto con un identificador de eventos en modo usuario.

El valor de propiedad (datos de operación) de esta propiedad es NULL porque no se devuelven datos de operación.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de estado de error.

status code	Significado
STATUS_NOT_SUPPORTED	No se admiten las notificaciones de eventos.
STATUS_INSUFFICIENT_RESOURCES	No se puede asignar memoria para el búfer.
STATUS_DEVICE_NOT_READY	El dispositivo no está listo.

Observaciones

Esta propiedad se usa para registrar eventos en modo de usuario para la notificación de eventos controlada por DMA.

Cuando el pin se coloca en el estado de ejecución (KSSTATE_RUN), los eventos registrados se señalizan una o dos veces por ciclo del búfer de audio cíclico, dependiendo del recuento de notificaciones solicitado cuando se llamó a KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION. Para obtener más información sobre KSSTATERUN, consulte el tema Transiciones de estado .

Después de detener el pin y antes de la hora en que se cierra, cada evento registrado se anula el registro a través de una llamada a KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.

Requisitos

Versión	Disponible en Windows Vista y en sistemas operativos Windows posteriores.
Encabezado	Ksmedia.h

Vea también

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

Transiciones de estado