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

ルーチンは FreeDmaBufferWithNotification 、 AllocateDmaBufferWithNotification の呼び出しによって以前に割り当てられた DMA バッファーを解放します。

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

構文

PFREE_DMA_BUFFER_WITH_NOTIFICATION PfreeDmaBufferWithNotification;

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

パラメーター

[in] _context

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

[in] Handle

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

[in] BufferMdl

バッファー MDL へのポインター。 この値は、AllocateDmaBufferWithNotification の以前の呼び出しから取得されました。

[in] BufferSize

解放するバッファーのサイズ。 この値は、AllocateDmaBufferWithNotification の以前の呼び出しから取得されました。

戻り値

FreeDmaBufferWithNotification は、呼び出しが成功した場合は STATUS_SUCCESS を返します。 それ以外の場合は、 FreeDmaBufferWithNotification 適切なエラー コードを返します。 次の表は、考えられるリターン エラー コードの一部を示しています。

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

注釈

ルーチンは FreeDmaBufferWithNotification AllocateDmaBufferWithNotification ルーチンと共に使用されます。 これら 2 つのルーチンは、HD Audio DDI のHDAUDIO_BUS_INTERFACE_V2 バージョンでのみ使用できます。

FreeDmaBufferWithNotification の呼び出し元は、IRQL PASSIVE_LEVELで実行されている必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	hdaudio.h (Hdaudio.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

AllocateCaptureDmaEngine

AllocateDmaBufferWithNotification

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE_V2