estrutura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)

Artigo
08/07/2023

A estrutura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION acrescenta um endereço base de buffer, um tamanho de buffer solicitado e uma contagem de notificações a uma estrutura KSPROPERTY . Essa estrutura é usada pelo cliente para solicitar a alocação do buffer de áudio por meio de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

Sintaxe

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

Membros

Property

Uma estrutura KSPROPERTY que o cliente inicializa adequadamente antes de chamar KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

BaseAddress

Especifica o endereço base do buffer. A menos que o cliente especifique um endereço base, esse parâmetro será definido como NULL.

RequestedBufferSize

Especifica o tamanho do buffer em bytes. O driver retorna o tamanho real do buffer alocado na estrutura KSRTAUDIO_BUFFER que retorna.

NotificationCount

Especifica o número de notificações por ciclo do buffer cíclico. Atualmente, os valores válidos são 1 ou 2. Um valor de 1 resulta em notificação para eventos de notificação registrados no final do buffer cíclico. Um valor de 2 resulta em notificações no ponto médio e no final do buffer cíclico.

Comentários

A solicitação KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION usa a estrutura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION para descrever o buffer cíclico que o cliente solicita. O driver retorna uma estrutura KSRTAUDIO_BUFFER para descrever o buffer realmente alocado.

Assim como acontece com KSPROPERTY_RTAUDIO_BUFFER, o valor que o cliente grava no membro RequestedBufferSize não é associação no driver.

Usar KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION facilita a sinalização de eventos à medida que o DMA progride por meio do buffer cíclico. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT é usado para registrar eventos para receber essas notificações e KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT é usado para cancelar o registro de eventos.