共用方式為

IMiniportWaveRT：：NewStream 方法 (portcls.h)

  • 發行項

NewStream方法會建立 WaveRT 數據流物件的新實例。

語法

NTSTATUS NewStream(
  [out] PMINIPORTWAVERTSTREAM *Stream,
  [in]  PPORTWAVERTSTREAM     PortStream,
  [in]  ULONG                 Pin,
  [in]  BOOLEAN               Capture,
  [in]  PKSDATAFORMAT         DataFormat
);

參數

[out] Stream

新數據流的輸出指標。 此參數指向呼叫端配置的指標變數， NewStream 此方法會將指標寫入新數據流物件的 IMiniportWaveRTStream 介面。 呼叫端會指定此參數的有效非 NULL 指標。

[in] PortStream

IPortWaveRTStream 的指標。

[in] Pin

指定可識別要開啟之針腳的釘選標識碼。 如果 WaveRT 迷你埠驅動程式的篩選描述元在篩選上指定了 n 個針腳處理站， 則 Pin 參數的有效值範圍是 0 到 n-1。 如需篩選描述元的詳細資訊，請參閱 Filter Factory 主題 。

[in] Capture

指定布爾值，指出是否要建立擷取數據流或轉譯數據流。 這個 參數適用於擷 取 (輸入) 數據流，針對播放 (輸出) 數據流則為 FALSE 。

[in] DataFormat

指定新數據流數據格式之 KSDATAFORMAT 結構的指標。 如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

NewStream 如果呼叫成功，則會傳回STATUS_SUCCESS。 否則，此方法會傳回適當的錯誤狀態代碼。

備註

方法 NewStream 會將數據流的初始狀態設定為 KSSTATE_STOP ，並將其初始位置設定為 0。 如需詳細資訊，請參閱相關方法 IMiniportWaveRTStream：：SetState 和 IMiniportWaveRTStream：：GetPosition。

DataFormat 參數會指定數據流的數據格式，指向下列其中一個特定音訊擴充版本的 KSDATAFORMAT 結構：

Stream 和 PortStream 參數遵循 COM 物件的參考計數慣例。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 Universal
標頭 portcls.h
IRQL 被動層級。

另請參閱

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream：：GetPosition

IMiniportWaveRTStream：：SetState

IPortWaveRTStream