Método IMiniportWaveRTStream::AllocateAudioBuffer (portcls.h)
O método AllocateAudioBuffer aloca um buffer cíclico para dados de áudio.
Sintaxe
NTSTATUS AllocateAudioBuffer(
ULONG RequestedSize,
PMDL *AudioBufferMdl,
ULONG *ActualSize,
ULONG *OffsetFromFirstPage,
MEMORY_CACHING_TYPE *CacheType
);
Parâmetros
RequestedSize
Especifica o tamanho solicitado, em bytes, do buffer de áudio.
AudioBufferMdl
Ponteiro de saída para uma MDL (lista de descritores de memória) que descreve o buffer de áudio. Esse parâmetro aponta para uma variável de ponteiro alocada pelo chamador na qual o método grava um ponteiro no MDL. Para obter informações gerais sobre MDLs de kernel do Windows, consulte Usando MDLs.
ActualSize
Ponteiro de saída para o tamanho real, em bytes, do buffer alocado. Esse parâmetro aponta para uma variável ULONG na qual o método grava o valor de tamanho.
OffsetFromFirstPage
Ponteiro de saída para o deslocamento do buffer, em bytes, desde o início da primeira página no MDL. Esse parâmetro aponta para uma variável ULONG alocada pelo chamador na qual o método grava o valor de deslocamento.
CacheType
Especifica o tipo de cache que o cliente solicita para o buffer de áudio. Esse parâmetro é um valor de enumeração MEMORY_CACHING_TYPE. Para obter mais informações, consulte a seção Comentários abaixo.
Retornar valor
Esse método retorna NTSTATUS. AllocateAudioBuffer retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um erro apropriado status código. A tabela a seguir mostra alguns dos possíveis códigos de status de erro.
| Código de retorno | Descrição |
|---|---|
| STATUS_UNSUCCESSFUL | O driver não dá suporte à combinação especificada de atributos de buffer. |
| STATUS_INSUFFICIENT_RESOURCES | A memória insuficiente está disponível para alocar o buffer. |
| STATUS_DEVICE_NOT_READY | O dispositivo não está pronto. |
Comentários
Observação: miniportos para codecs de áudio de alta definição intel devem especificar um CacheType de MmWriteCombined para garantir a coerência do cache. Isso ocorre porque o Controlador de Áudio de Alta Definição da Intel pode estar configurado para a operação não bisbilhoteira.
Depois de receber uma solicitação KSPROPERTY_RTAUDIO_BUFFER do cliente, o driver de porta chama o método AllocateAudioBuffer para alocar um buffer cíclico que o driver de porta pode mapear posteriormente para o espaço de endereço virtual do cliente.
Durante a chamada para AllocateAudioBuffer, o driver de miniporto aloca o buffer cíclico chamando IPortWaveRTStream::AllocatePagesForMdl ou IPortWaveRTStream::AllocateContiguousPagesForMdl. O driver de miniporto também programa o hardware de áudio a ser reproduzido ou registrado nesse buffer, mas não inicia as transferências de DMA até que o driver de porta chame IMiniportWaveRTStream::SetState com State=KSSTATE_RUN. Os parâmetros de saída do método AllocateAudioBuffer incluem o MDL para o buffer de áudio, o tamanho real do buffer alocado pelo driver e o deslocamento do início do buffer desde o início da primeira página no MDL.
RequestedSize é um parâmetro de entrada que indica o tamanho que o cliente está solicitando para o buffer de áudio. ActualSize é um parâmetro de saída que indica o tamanho real do buffer de áudio.
O dispositivo de áudio pode exigir que o buffer de áudio comece e termine em limites de exemplo ou para atender a outros tipos de restrições de alinhamento dependentes de hardware. Se houver memória suficiente disponível, o tamanho real do buffer será o tamanho solicitado arredondado (para cima ou para baixo) para o exemplo mais próximo ou outro limite restrito por hardware. O tamanho real deve ser pelo menos o tamanho solicitado; caso contrário, o mecanismo de áudio da API de Sessão de Áudio (WASAPI) não usará o buffer e a criação do fluxo falhará.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | portcls.h |
| IRQL | PASSIVE_LEVEL |