IAllocatorMXF::GetMessage メソッド (dmusicks.h)

GetMessage メソッドは、ポートドライバーのアロケーターを使用して DMUS_KERNEL_EVENT 構造体を再利用する DirectMusic カーネルモードコンポーネントの取得ポイントとして機能します。

構文

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

[out] ppDMKEvt

MIDI イベントの出力ポインター。このパラメーターは、アロケーターから取得されるイベント構造体へのポインターをメソッドが書き込む呼び出し元によって割り当てられたポインター変数を指します。構造体自体は空です (アロケーターによってゼロにされます)。

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

ミニポートドライバーは、MIDI レンダリングとキャプチャのイベント構造を取得する GetMessage メソッドを使用します。このメソッドは、IMXF::P utMessage アロケーターに破棄する場合に格納するのと同じプールから DMUS_KERNEL_EVENT 構造体を取得します。

MIDI キャプチャストリームの場合、ポートドライバーは、通常のサービス DPC によってメッセージが表示されたときにミニポートドライバーからキャプチャイベントを取得します。

アロケーターの詳細については、「アロケーターのをする」を参照してください。