(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