estructura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)

  • Artículo

La estructura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION anexa una dirección base del búfer, un tamaño de búfer solicitado y un recuento de notificaciones a una estructura KSPROPERTY . El cliente usa esta estructura para solicitar la asignación del búfer de audio a través de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

Sintaxis

typedef struct {
  KSPROPERTY Property;
  PVOID      BaseAddress;
  ULONG      RequestedBufferSize;
  ULONG      NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;

Miembros

Property

Una estructura KSPROPERTY que el cliente inicializa correctamente antes de llamar a KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

BaseAddress

Especifica la dirección base del búfer. A menos que el cliente especifique una dirección base, este parámetro se establece en NULL.

RequestedBufferSize

Especifica el tamaño del búfer en bytes. El controlador devuelve el tamaño real del búfer asignado en la estructura KSRTAUDIO_BUFFER que devuelve.

NotificationCount

Especifica el número de notificaciones por ciclo del búfer cíclico. Actualmente, los valores válidos son 1 o 2. Un valor de 1 da como resultado la notificación a los eventos de notificación registrados al final del búfer cíclico. Un valor de 2 da como resultado notificaciones tanto en el punto medio como en el final del búfer cíclico.

Comentarios

La solicitud de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION usa la estructura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION para describir el búfer cíclico que solicita el cliente. El controlador devuelve una estructura KSRTAUDIO_BUFFER para describir el búfer asignado realmente.

Al igual que con KSPROPERTY_RTAUDIO_BUFFER, el valor que el cliente escribe en el miembro RequestedBufferSize no está enlazando en el controlador.

El uso de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION facilita la señalización de eventos a medida que DMA avanza a través del búfer cíclico. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT se usa para registrar eventos para recibir estas notificaciones y KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT se usa para anular el registro de eventos.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y en sistemas operativos Windows posteriores.
Encabezado ksmedia.h

Consulte también

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT