IMXF::P utMessage 方法(dmusicks.h)
PutMessage 方法将DMUS_KERNEL_EVENT结构传递给其下一个目标。 微型端口驱动程序使用此方法放弃已使用的事件结构,以便分配器可以回收它们。
语法
语法
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
参数
pDMKEvt
指向要传递给其目标的DMUS_KERNEL_EVENT结构的指针。
返回值
此方法返回 NTSTATUS,如果调用成功,则返回包含STATUS_SUCCESS。 否则,该方法将返回适当的错误代码。
言论
在呈现期间,微型端口驱动程序调用 PutMessage 方法以放弃已用DMUS_KERNEL_EVENT结构。 该方法将丢弃的结构路由到分配器以重复使用。 微型端口驱动程序从要呈现的结构中提取 MIDI 数据后调用此方法。
在 MIDI 捕获期间,此方法用于打包 MIDI 消息并将其传递到 DMus 端口驱动程序的捕获接收器,如图中 MIDI Transport 所示。 这些消息可以是单个、多个或碎片的 MIDI 事件,并打包在DMUS_KERNEL_EVENT结构中(IAllocatorMXF::GetMessage 调用检索)。
分配器始终是任何链中的最后一个目标,因此最终将回收每个DMUS_KERNEL_EVENT结构。 如果未调用 IMXF::ConnectOutput,PutMessage 将默认将结构传递给分配器。 有关详细信息,请参阅分配器。
要求
要求 | 价值 |
---|---|
标头 | dmusicks.h |
IRQL | DISPATCH_LEVEL |