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

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

構文

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

[out] ppDMKEvt

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

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

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

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

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