共用方式為


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訊息,並將MIDI訊息傳遞至 DMus 埠驅動程式的擷取接收,如MIDI Transport中的圖所示。 這些訊息可以是單一、多個或分散的MIDI事件,並封裝在DMUS_KERNEL_EVENT結構中(IAllocatorMXF::GetMessage 呼叫所擷取)。

配置器一律是任何鏈結中的最後一個目的地,因此最終會回收每個DMUS_KERNEL_EVENT結構。 如果尚未呼叫 IMXF::ConnectOutput,PutMessage 預設會將結構傳遞至配置器。 如需詳細資訊,請參閱配置器。

要求

要求 價值
標頭 dmusicks.h
IRQL DISPATCH_LEVEL

另請參閱

IMXF