IMXF：:P utMessage 方法 (dmusicks.h)

  • 项目

PutMessage 方法将DMUS_KERNEL_EVENT结构传递到其下一个目标。 微型端口驱动程序使用此方法放弃使用的事件结构，以便分配器可以回收它们。

语法

语法

NTSTATUS PutMessage(
  PDMUS_KERNEL_EVENT pDMKEvt
);

参数

pDMKEvt

指向要传递到其目标的DMUS_KERNEL_EVENT结构的指针。

返回值

如果调用成功，此方法返回包含STATUS_SUCCESS的 NTSTATUS。 否则，该方法将返回相应的错误代码。

注解

在呈现期间，微型端口驱动程序调用 PutMessage 方法以放弃使用DMUS_KERNEL_EVENT结构。 方法将丢弃的结构路由到分配器以供重复使用。 微型端口驱动程序在从结构中提取 MIDI 数据以供呈现后，会调用此方法。

在 MIDI 捕获期间，此方法用于打包 MIDI 消息并将其传递到 DMus 端口驱动程序的捕获接收器，如 MIDI 传输中的图中所示。 这些消息可以是单个、多个或片断的 MIDI 事件，并打包在DMUS_KERNEL_EVENT结构中， (这些结构由 IAllocatorMXF：：GetMessage 调用) 检索。

分配器始终是任何链中的最后一个目标，因此最终将回收每个DMUS_KERNEL_EVENT结构。 如果未调用 IMXF：：ConnectOutput，PutMessage 将默认将结构传递给分配器。 有关详细信息，请参阅分配器。

要求

要求 值
Header dmusicks.h
IRQL DISPATCH_LEVEL

另请参阅

IMXF