IMXF::P utMessage メソッド (dmusicks.h)

PutMessage メソッドは、次の宛先にDMUS_KERNEL_EVENT構造体を渡します。 ミニポート ドライバーは、アロケーターによってリサイクルできるように、使用されるイベント構造を破棄するには、このメソッドを使用します。

構文

構文

NTSTATUS PutMessage(
  PDMUS_KERNEL_EVENT pDMKEvt
);

パラメーター

pDMKEvt

宛先に渡されるDMUS_KERNEL_EVENT構造体へのポインター。

戻り値

このメソッドは、呼び出しが成功した場合にSTATUS_SUCCESSを含む NTSTATUS を返します。 それ以外の場合、メソッドは適切なエラー コードを返します。

備考

レンダリング中、ミニポート ドライバーは PutMessage メソッドを呼び出して、使用されるDMUS_KERNEL_EVENT構造体を破棄します。 このメソッドは、破棄された構造体を再利用のためにアロケーターにルーティングします。 ミニポート ドライバーは、レンダリング用の構造体から MIDI データを抽出した後、このメソッドを呼び出します。

MIDI キャプチャ中は、MIDI トランスポートの図に示すように、このメソッドを使用して、DMus ポート ドライバーのキャプチャ シンクに MIDI メッセージをパッケージ化して渡します。 これらのメッセージは、単一、複数、または断片的な MIDI イベントにすることができ、DMUS_KERNEL_EVENT構造体 (IAllocatorMXF::GetMessage 呼び出しによって取得される) にパッケージ化されます。

アロケーターは常に任意のチェーンの最後の宛先であるため、すべてのDMUS_KERNEL_EVENT構造が最終的にリサイクルされます。 IMXF::ConnectOutput が呼び出されていない場合、PutMessage は既定でアロケーターに構造体を渡します。 詳細については、「アロケーター」を参照してください。

必要条件

要件	価値
ヘッダー	dmusicks.h
IRQL	DISPATCH_LEVEL

関連項目

IMXF を する