PFREE_DMA_BUFFER_WITH_NOTIFICATION função de retorno de chamada (hdaudio.h)
A FreeDmaBufferWithNotification rotina libera um buffer de AMD que foi alocado anteriormente por uma chamada para AllocateDmaBufferWithNotification.
O tipo de ponteiro de função para uma rotina FreeDmaBufferWithNotification é definido da seguinte maneira.
Sintaxe
PFREE_DMA_BUFFER_WITH_NOTIFICATION PfreeDmaBufferWithNotification;
NTSTATUS PfreeDmaBufferWithNotification(
[in] PVOID _context,
[in] HANDLE Handle,
[in] PMDL BufferMdl,
[in] SIZE_T BufferSize
)
{...}
Parâmetros
[in] _context
Especifica o valor de contexto do membro Context da estrutura HDAUDIO_BUS_INTERFACE_V2 .
[in] Handle
Identificador que identifica o mecanismo de DMA. Esse valor de identificador foi obtido de uma chamada anterior para AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.
[in] BufferMdl
Um ponteiro para o MDL do buffer. Esse valor foi obtido de uma chamada anterior para AllocateDmaBufferWithNotification.
[in] BufferSize
O tamanho do buffer a ser liberado. Esse valor foi obtido de uma chamada anterior para AllocateDmaBufferWithNotification.
Retornar valor
FreeDmaBufferWithNotification retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, FreeDmaBufferWithNotification retornará um código de erro apropriado. A tabela a seguir mostra alguns dos possíveis códigos de erro de retorno.
| Código de retorno | Descrição |
|---|---|
|
Indica que o chamador está em execução em um IRQL muito alto. |
|
Indica que o valor do parâmetro handle é inválido. |
|
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 FreeDmaBufferWithNotification rotina é usada junto com a rotina AllocateDmaBufferWithNotification. Essas duas rotinas estão disponíveis apenas na versão HDAUDIO_BUS_INTERFACE_V2 da DDI de áudio HD.
Os chamadores de FreeDmaBufferWithNotification devem estar em execução no IRQL PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | hdaudio.h (inclua Hdaudio.h) |
| IRQL | PASSIVE_LEVEL |