IMiniportMidi::NewStream 方法 (portcls.h)
NewStream
方法會建立與指定實體通道相關聯的邏輯數據流的新實例。
語法
NTSTATUS NewStream(
[out] PMINIPORTMIDISTREAM *Stream,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] ULONG Pin,
[in] BOOLEAN Capture,
[in] PKSDATAFORMAT DataFormat,
[out] PSERVICEGROUP *ServiceGroup
);
參數
[out] Stream
新數據流的輸出指標。 此參數指向呼叫端配置的指標變數,方法會將指標寫入數據流物件的 IMiniportMidiStream 介面。
[in, optional] OuterUnknown
需要匯總數據流物件的 IUnknown 介面指標。 這個參數是選擇性的。 如果不需要匯總,呼叫端會將此參數指定為 null 。
[in] PoolType
指定應該從中配置 DMA 通道物件的記憶體的記憶體的記憶體集區類型。 此參數會設定為其中一個 POOL_TYPE 列舉值。
[in] Pin
指定釘選標識碼。 此參數會識別要開啟的針腳。 如果MIDI迷你埠物件的 IMiniport::GetDescription 方法會輸出篩選描述項,指定篩選上 n 個 針腳處理站的總,則有效的針腳標識符範圍介於 0 到 n-1。
[in] Capture
指定通道是要用於擷取還是播放。 如果 TRUE,則為擷取(輸入)通道。 如果 FALSE,則它是播放(輸出)通道。
[in] DataFormat
KSDATAFORMAT 結構的指標,指定要用於這個數據流實例的數據格式。
[out] ServiceGroup
服務群組的輸出指標。 此參數指向呼叫端配置的指標變數,方法會將指標寫入數據流服務群組物件的 IServiceGroup 介面。 這是正在註冊以接收中斷通知的服務群組。
傳回值
如果呼叫成功,NewStream
會傳回STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。
言論
NewStream
方法會將數據流的初始狀態設定為 KSSTATE_STOP。
Stream、OuterUnknown和 ServiceGroup 參數遵循 COM 物件的 參考計數慣例。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | portcls.h (包括 Portcls.h) |
IRQL | PASSIVE_LEVEL |