IAllocatorMXF::GetMessage 方法 (dmusicks.h)
GetMessage
方法可作為任何 DirectMusic 內核模式元件的擷取點,該元件利用埠驅動程式的配置器重複使用 DMUS_KERNEL_EVENT 結構。
語法
NTSTATUS GetMessage(
[out] PDMUS_KERNEL_EVENT *ppDMKEvt
);
參數
[out] ppDMKEvt
MIDI 事件的輸出指標。 此參數指向呼叫端配置的指標變數,方法會將指標寫入要從配置器擷取的事件結構。 結構本身是空的(配置器為零)。
傳回值
如果呼叫成功,GetMessage
會傳回S_OK。 否則,方法會傳回適當的錯誤碼。
言論
迷你埠驅動程式會使用 GetMessage
方法來擷取 MIDI 轉譯和擷取的事件結構。 這個方法會從 IMXF::P utMessage 的相同集區擷取 DMUS_KERNEL_EVENT 結構, 將它們捨棄至配置器時放入其中。
在MIDI擷取數據流的情況下,埠驅動程式會在一般服務 DPC 提示時,從迷你埠驅動程式擷取事件。
如需設定器的詳細資訊,請參閱 設定器。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dmusicks.h (包括 Dmusicks.h) |
IRQL | <=DISPATCH_LEVEL |