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 提示时从微型端口驱动程序中检索捕获事件。

有关分配器的详细信息，请参阅分配器。