Compartilhar via


estrutura KSRTAUDIO_BUFFER_PROPERTY

A estrutura KSRTAUDIO_BUFFER_PROPERTY acrescenta um endereço base do buffer e o tamanho do buffer solicitado a uma estrutura KSPROPERTY . Essa estrutura é usada pelo cliente para solicitar a alocação do buffer de áudio por meio de KSPROPERTY_RTAUDIO_BUFFER.

Sintaxe

typedef struct {
  KSPROPERTY Property;
  PVOID      BaseAddress;
  ULONG      RequestedBufferSize;
} KSRTAUDIO_BUFFER_PROPERTY, *PKSRTAUDIO_BUFFER_PROPERTY;

Membros

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

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

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

Comentários

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

O valor que o cliente grava no membro RequestedBufferSize não é associação no driver. No entanto, o driver deve especificar um tamanho de buffer o mais próximo possível do tamanho solicitado, levando em conta as restrições de tamanho do buffer no próprio driver. O driver alocará um buffer de um tamanho diferente se o hardware não puder lidar com o tamanho solicitado ou se o sistema estiver com pouca memória. Por exemplo, um driver aloca um buffer não menor que uma página de memória ou arredonda o tamanho do buffer para baixo para o próximo bloco de exemplo inteiro. Além disso, se o sistema estiver com pouca memória, o driver alocará um buffer menor que o tamanho solicitado.

Requisitos

Versão

Disponível no Windows Vista e em sistemas operacionais Windows posteriores.

parâmetro

Ksmedia.h