ITStreamControl::CreateStream 方法 (tapi3if.h)
CreateStream方法會建立新的媒體資料流程。
語法
HRESULT CreateStream(
[in] long lMediaType,
[in] TERMINAL_DIRECTION td,
[out] ITStream **ppStream
);
參數
[in] lMediaType
指出資料流程的 媒體類型 。
[in] td
[out] ppStream
新建立 ITStream 介面的指標指標。
傳回值
這個方法可以傳回其中一個值。
值 | 意義 |
---|---|
|
方法成功。 |
|
ppStream參數不是有效的指標。 |
|
記憶體不足,無法執行作業。 |
|
lMediaType參數不是有效的媒體類型。 |
|
td參數不是有效的終端方向。 |
|
已達到支援的資料流程數目上限。 |
|
不支援此作業。 |
備註
許多 MSP 都不支援動態建立資料流程,只要在此方法的實作中傳回TAPI_E_MAXSTREAMS即可。 建立呼叫時會自動提供預設資料流程,因此大部分的應用程式都不需要使用此方法。
串流建立或移除可能會牽涉到與遠端端點的互動,導致CMC_REMOTE_REQUEST,而不是在停止或啟動資料流程時收到的CMC_LOCAL_REQUEST訊息。
TAPI 會在ITStreamControl::CreateStream所傳回的 ITStream介面上呼叫AddRef方法。 應用程式必須在ITStream介面上呼叫Release,以釋放與其相關聯的資源。
需求
目標平台 | Windows |
標頭 | tapi3if.h (包括 Tapi3.h) |