Share via

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

  • Artigo

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
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 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

Confira também

AllocateCaptureDmaEngine

AllocateDmaBufferWithNotification

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE_V2