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

Artigo
02/26/2024

A FreeDmaEngine rotina libera um mecanismo de DMA que foi alocado anteriormente por uma chamada para AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.

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

Sintaxe

PFREE_DMA_ENGINE PfreeDmaEngine;

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

Parâmetros

[in] _context

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

[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

FreeDmaEngine retornará STATUS_SUCCESS se a chamada for bem-sucedida na liberação do mecanismo de AMD. 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_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 um buffer ainda está alocado para o mecanismo de DMA.

Comentários

Essa rotina libera um mecanismo de AMD que foi previamente reservado por uma chamada para a rotina AllocateCaptureDmaEngine ou AllocateRenderDmaEngine .

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

Nenhum buffer de AMD alocado anteriormente não foi liberado (chamando FreeDmaBuffer ou FreeContiguousDmaBuffer).
O fluxo está em um estado diferente de redefinir.

Um driver de áudio chama essa rotina para fechar o pino (e destruir o fluxo).