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 |