KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

La propiedad KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT anula el registro de un evento en modo de usuario de la notificación de eventos controlada por DMA.

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 de 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_UNREGISTER_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 anular el registro de eventos en modo de usuario de la notificación de eventos controladas por DMA.

Cuando la patilla se coloca en el estado de ejecución (KSSTATE_RUN), los eventos registrados se indican 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 KSSTATE_RUN, vea el tema Transiciones de estado .

Después de detener el pin y antes del paso donde se cierra, cada evento registrado debe anularse mediante 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

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT