PFREE_DMA_ENGINE コールバック関数 (hdaudio.h)

ルーチンは FreeDmaEngine 、 AllocateCaptureDmaEngine または AllocateRenderDmaEngine の呼び出しによって以前に割り当てられた DMA エンジンを解放します。

ルーチンの関数ポインター型 FreeDmaEngine は、次のように定義されます。

構文

PFREE_DMA_ENGINE PfreeDmaEngine;

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

[in] _context

HDAUDIO_BUS_INTERFACE、HDAUDIO_BUS_INTERFACE_V2、または HDAUDIO_BUS_INTERFACE_BDL 構造体の Context メンバーのコンテキスト値を指定します。

[in] Handle

DMA エンジンを識別するハンドル。このハンドル値は、 AllocateCaptureDmaEngine または AllocateRenderDmaEngine の以前の呼び出しから取得されました。

FreeDmaEngine は、呼び出しが DMA エンジンの解放に成功した場合にSTATUS_SUCCESSを返します。それ以外の場合、ルーチンは適切なエラーコードを返します。次の表は、可能な戻り状態コードの一部を示しています。

リターンコード	説明
STATUS_INVALID_HANDLE	ハンドルパラメーターの値が無効であることを示します。
STATUS_INVALID_DEVICE_REQUEST	ストリームがリセット状態ではないこと、または DMA エンジンにバッファーがまだ割り当てられていることを示します。