PFREE_DMA_BUFFER回呼函式 (hdaudio.h)

發行項
02/27/2024

FreeDmaBuffer例程會釋放先前由 AllocateDmaBuffer 呼叫所配置的 DMA 緩衝區。

例程的 FreeDmaBuffer 函式指標類型定義如下。

語法

PFREE_DMA_BUFFER PfreeDmaBuffer;

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

參數

[in] _context

指定HDAUDIO_BUS_INTERFACE或HDAUDIO_BUS_INTERFACE_V2結構之Context成員的內容值。

[in] Handle

處理識別 DMA 引擎。這個句柄值是從先前呼叫 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 取得。

傳回值

FreeDmaBuffer 如果呼叫成功，則會傳回STATUS_SUCCESS。否則，例程會傳回適當的錯誤碼。下表顯示一些可能的傳回狀態代碼。

傳回碼	Description
STATUS_UNSUCCESSFUL	表示呼叫端在太高 IRQL 上執行。
STATUS_INVALID_HANDLE	表示 handle 參數值無效。
STATUS_INVALID_DEVICE_REQUEST	表示數據流未處於重設狀態，或目前未為 DMA 引擎配置任何緩衝區。

備註

例 FreeDmaBuffer 程會與 AllocateDmaBuffer 例程搭配使用。這兩個例程僅適用於 HD 音訊 DDI 的 HDAUDIO_BUS_INTERFACE 版本。此 DDI 不包含 AllocateContiguousDmaBuffer、 SetupDmaEngineWithBdl 和 FreeContiguousDmaBuffer 例程，這些例程永遠不會與 AllocateDmaBuffer 和 FreeDmaBuffer搭配使用。不同於 SetupDmaEngineWithBdl，它會將 DMA 引擎設定為使用先前配置的 DMA 緩衝區， AllocateDmaBuffer 會配置 DMA 緩衝區，並將 DMA 引擎設定為使用緩衝區。

例程失敗，並在下列任一情況下傳回錯誤碼STATUS_INVALID_DEVICE_REQUEST：