estrutura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e em sistemas operacionais Windows posteriores. |
| Cabeçalho | ksmedia.h |
Confira também
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION