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 物件的參考計數慣例。

規格需求

需求 值
目標平台 Universal
標頭 portcls.h (包含 Portcls.h)
IRQL PASSIVE_LEVEL

另請參閱

IMiniport：：GetDescription

IMiniportMidi

IMiniportMidiStream

IServiceGroup

KSDATAFORMAT

POOL_TYPE