PFREE_DMA_BUFFER_WITH_NOTIFICATION funzione di callback (hdaudio.h)

Articolo
02/29/2024

La FreeDmaBufferWithNotification routine libera un buffer DMA allocato in precedenza da una chiamata a AllocateDmaBufferWithNotification.

Il tipo di puntatore della funzione per una routine FreeDmaBufferWithNotification è definito come indicato di seguito.

Sintassi

PFREE_DMA_BUFFER_WITH_NOTIFICATION PfreeDmaBufferWithNotification;

NTSTATUS PfreeDmaBufferWithNotification(
  [in] PVOID _context,
  [in] HANDLE Handle,
  [in] PMDL BufferMdl,
  [in] SIZE_T BufferSize
)
{...}

Parametri

[in] _context

Specifica il valore di contesto dal membro Contesto della struttura HDAUDIO_BUS_INTERFACE_V2 .

[in] Handle

Handle che identifica il motore DMA. Questo valore di handle è stato ottenuto da una chiamata precedente a AllocateCaptureDmaEngine o AllocateRenderDmaEngine.

[in] BufferMdl

Puntatore al buffer MDL. Questo valore è stato ottenuto da una chiamata precedente a AllocateDmaBufferWithNotification.

[in] BufferSize

Dimensione del buffer da liberare. Questo valore è stato ottenuto da una chiamata precedente a AllocateDmaBufferWithNotification.

Valore restituito

FreeDmaBufferWithNotification restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, FreeDmaBufferWithNotification restituisce un codice di errore appropriato. La tabella seguente mostra alcuni dei possibili codici di errore restituiti.

Codice restituito	Descrizione
STATUS_UNSUCCESSFUL	Indica che il chiamante è in esecuzione in un irQL troppo elevato.
STATUS_INVALID_HANDLE	Indica che il valore del parametro handle non è valido.
STATUS_INVALID_DEVICE_REQUEST	Indica che il flusso non è nello stato di reimpostazione o che non è attualmente allocato alcun buffer per il motore DMA.

Commenti

La FreeDmaBufferWithNotification routine viene usata insieme alla routine AllocateDmaBufferWithNotification. Queste due routine sono disponibili solo nella versione HDAUDIO_BUS_INTERFACE_V2 di HD Audio DDI.

I chiamanti di FreeDmaBufferWithNotification devono essere in esecuzione all'PASSIVE_LEVEL IRQL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	hdaudio.h (includere Hdaudio.h)
IRQL	PASSIVE_LEVEL

Vedi anche

AllocateCaptureDmaEngine

AllocateDmaBufferWithNotification

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE_V2

Condividi tramite