共用方式為


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

PutMessage 方法會將DMUS_KERNEL_EVENT結構傳遞至其下一個目的地。 迷你埠驅動程式會使用這個方法來捨棄已使用的事件結構,讓配置器可以回收它們。

Syntax

語法

NTSTATUS PutMessage(
  PDMUS_KERNEL_EVENT pDMKEvt
);

參數

pDMKEvt

傳遞至目的地之DMUS_KERNEL_EVENT結構的指標。

傳回值

如果呼叫成功,這個方法會傳回NTSTATUS,其中包含STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。

備註

在轉譯期間,迷你埠驅動程式會呼叫 PutMessage 方法來捨棄使用的DMUS_KERNEL_EVENT結構。 方法會將捨棄的結構路由傳送至配置器以重複使用。 迷你埠驅動程序從結構擷取MIDI數據以進行轉譯之後,就會呼叫此方法。

在MIDI擷取期間,這個方法可用來封裝MIDI訊息,並將MIDI訊息傳遞至 DMus 埠驅動程式的擷取接收,如下圖所示。 這些訊息可以是單一、多個或片段 MIDI 事件,而且會封裝在DMUS_KERNEL_EVENT結構中, (IAllocatorMXF::GetMessage 呼叫) 擷取這些訊息。

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

規格需求

需求
標頭 dmusicks.h
IRQL DISPATCH_LEVEL

另請參閱

IMXF