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 は既定で構造体をアロケーターに渡します。 詳細については、「Allocator」を参照してください。
要件
要件 | 値 |
---|---|
Header | dmusicks.h |
IRQL | DISPATCH_LEVEL |