PFREE_DMA_BUFFER função de retorno de chamada (hdaudio.h)

Artigo
02/26/2024

A FreeDmaBuffer rotina libera um buffer de AMD que foi alocado anteriormente por uma chamada para AllocateDmaBuffer.

O tipo de ponteiro de função para uma FreeDmaBuffer rotina é definido da seguinte maneira.

Sintaxe

PFREE_DMA_BUFFER PfreeDmaBuffer;

NTSTATUS PfreeDmaBuffer(
  [in] PVOID _context,
  [in] HANDLE Handle
)
{...}

Parâmetros

[in] _context

Especifica o valor de contexto do membro Context do HDAUDIO_BUS_INTERFACE ou da estrutura HDAUDIO_BUS_INTERFACE_V2 .

[in] Handle

Manipule a identificação do mecanismo de AMD. Esse valor de identificador foi obtido de uma chamada anterior para AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.

Retornar valor

FreeDmaBuffer retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, a rotina retornará um código de erro apropriado. A tabela a seguir mostra alguns dos possíveis códigos de status de retorno.

Código de retorno	Descrição
STATUS_UNSUCCESSFUL	Indica que o chamador está em execução em um IRQL muito alto.
STATUS_INVALID_HANDLE	Indica que o valor do parâmetro handle é inválido.
STATUS_INVALID_DEVICE_REQUEST	Indica que o fluxo não está no estado de redefinição ou que nenhum buffer está alocado no momento para o mecanismo de DMA.

Comentários

A FreeDmaBuffer rotina é usada em conjunto com a rotina AllocateDmaBuffer . Essas duas rotinas estão disponíveis apenas na versão HDAUDIO_BUS_INTERFACE da DDI de áudio HD. Essa DDI não inclui as rotinas AllocateContiguousDmaBuffer, SetupDmaEngineWithBdl e FreeContiguousDmaBuffer , que nunca são usadas em conjunto com AllocateDmaBuffer e FreeDmaBuffer. Ao contrário de SetupDmaEngineWithBdl, que configura o mecanismo de DMA para usar um buffer de DMA alocado anteriormente, AllocateDmaBuffer aloca um buffer de DMA e configura o mecanismo de DMA para usar o buffer.

A rotina falha e retorna o código de erro STATUS_INVALID_DEVICE_REQUEST em qualquer uma das seguintes circunstâncias:

O cliente chama FreeDmaBuffer quando nenhum buffer está alocado no momento para o mecanismo de DMA.
O fluxo está em um estado diferente de redefinir.