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

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