IAllocatorMXF：：GetMessage 方法（dmusicks.h）

GetMessage 方法可作為任何 DirectMusic 內核模式元件的擷取點，該元件利用埠驅動程式的配置器重複使用 DMUS_KERNEL_EVENT 結構。

語法

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

[out] ppDMKEvt

MIDI 事件的輸出指標。此參數指向呼叫端配置的指標變數，方法會將指標寫入要從配置器擷取的事件結構。結構本身是空的（配置器為零）。

如果呼叫成功，GetMessage 會傳回S_OK。否則，方法會傳回適當的錯誤碼。

迷你埠驅動程式會使用 GetMessage 方法來擷取 MIDI 轉譯和擷取的事件結構。這個方法會從 IMXF：:P utMessage 的相同集區擷取 DMUS_KERNEL_EVENT 結構，將它們捨棄至配置器時放入其中。

在MIDI擷取數據流的情況下，埠驅動程式會在一般服務 DPC 提示時，從迷你埠驅動程式擷取事件。

如需設定器的詳細資訊，請參閱設定器。