次の方法で共有


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

こちらもご覧ください

IMXF