PFREE_DMA_BUFFER回呼函式 （hdaudio.h）
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。 否則，例程會傳回適當的錯誤碼。 下表顯示一些可能的傳回狀態代碼。
| 傳回碼 | 描述 |
|---|---|
|
表示呼叫端在 IRQL 執行時太高。 |
|
表示 handle 參數值無效。 |
|
表示數據流未處於重設狀態，或目前未配置任何緩衝區給 DMA 引擎。 |
言論
FreeDmaBuffer 例程會與 AllocateDmaBuffer 例程搭配使用。 這兩個例程僅適用於 HD 音訊 DDI HDAUDIO_BUS_INTERFACE 版本。 此 DDI 不包含 AllocateContiguousDmaBuffer、SetupDmaEngineWithBdl和 FreeContiguousDmaBuffer 例程，這些例程永遠不會與 AllocateDmaBuffer 和 FreeDmaBuffer搭配使用。 不同於 SetupDmaEngineWithBdl，它會將 DMA 引擎設定為使用先前配置的 DMA 緩衝區，AllocateDmaBuffer 都會配置 DMA 緩衝區，並將 DMA 引擎設定為使用緩衝區。
例程會失敗，並在下列任一情況下傳回錯誤碼STATUS_INVALID_DEVICE_REQUEST：
-
當目前未配置任何緩衝區給 DMA 引擎時，用戶端會呼叫
FreeDmaBuffer。 - 數據流處於重設以外的狀態。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | hdaudio.h （包括 Hdaudio.h） |
| IRQL | PASSIVE_LEVEL |