共用方式為


ITStreamControl::CreateStream 方法 (tapi3if.h)

CreateStream方法會建立新的媒體資料流程。

語法

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

參數

[in] lMediaType

指出資料流程的 媒體類型

[in] td

表示 TERMINAL_DIRECTION

[out] ppStream

新建立 ITStream 介面的指標指標。

傳回值

這個方法可以傳回其中一個值。

意義
S_OK
方法成功。
E_POINTER
ppStream參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法執行作業。
TAPI_E_INVALIDMEDIATYPE
lMediaType參數不是有效的媒體類型。
TAPI_E_INVALIDDIRECTION
td參數不是有效的終端方向。
TAPI_E_MAXSTREAMS
已達到支援的資料流程數目上限。
TAPI_E_NOTSUPPORTED
不支援此作業。

備註

許多 MSP 都不支援動態建立資料流程,只要在此方法的實作中傳回TAPI_E_MAXSTREAMS即可。 建立呼叫時會自動提供預設資料流程,因此大部分的應用程式都不需要使用此方法。

串流建立或移除可能會牽涉到與遠端端點的互動,導致CMC_REMOTE_REQUEST,而不是在停止或啟動資料流程時收到的CMC_LOCAL_REQUEST訊息。

TAPI 會在ITStreamControl::CreateStream所傳回的 ITStream介面上呼叫AddRef方法。 應用程式必須在ITStream介面上呼叫Release,以釋放與其相關聯的資源。

需求

   
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)

另請參閱

ITStreamControl

媒體服務提供者介面 (MSPI)

TERMINAL_DIRECTION

媒體類型