PFREE_DMA_ENGINE回呼函式 (hdaudio.h)

例 FreeDmaEngine 程會釋放先前由 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 呼叫所配置的 DMA 引擎。

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

語法

PFREE_DMA_ENGINE PfreeDmaEngine;

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

[in] _context

[in] Handle

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

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

傳回碼	Description
STATUS_INVALID_HANDLE	表示 handle 參數值無效。
STATUS_INVALID_DEVICE_REQUEST	表示數據流未處於重設狀態，或仍為 DMA 引擎配置緩衝區。

此例程會釋放先前由 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 例程所保留的 DMA 引擎。

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

音訊驅動程式會呼叫此例程，以關閉針腳 (並終結數據流) 。