ITTerminalManager::CreateDynamicTerminal 方法 (termmgr.h)
CreateDynamicTerminal 方法會建立指定終端類別、媒體類型和方向的動態終端機。
語法
HRESULT CreateDynamicTerminal(
[in] IUnknown *pOuterUnknown,
[in] IID iidTerminalClass,
[in] DWORD dwMediaType,
[in] TERMINAL_DIRECTION Direction,
[in] MSP_HANDLE htAddress,
[out] ITTerminal **ppTerminal
);
參數
[in] pOuterUnknown
如果 MSP 會匯總終端物件,請將 設定為 MSP 物件的 IUnknown 介面指標。 這通常會設定為 NULL。
[in] iidTerminalClass
要建立之終端機類別的 GUID。
[in] dwMediaType
數據流
[in] Direction
TERMINAL_DIRECTION 終端機之媒體數據流方向的描述元。
[in] htAddress
MSP 句柄。
[out] ppTerminal
新終端機 ITTerminal 介面的指標。
傳回值
這個方法可以傳回其中一個值。
價值 | 意義 |
---|---|
|
方法成功。 |
|
fMessageWaiting 參數無效。 |
|
ppAddress 參數不是有效的指標。 |
言論
pTerminalClass選擇值時,唯一可以使用的終端機類別 GUID 就是對應至「動態」建立的終端機。 例如,從 TAPI3 目前定義的所有終端機類別中,只能搭配 CreateTerminal 使用下列專案:CLSID_MediaStreamTerminal和CLSID_VideoWindowTerm。
此外,只能使用此位址支援的動態終端機類別。 應用程式可以使用 ITTerminalSupport::EnumerateDynamicTerminalClasses 或 ITTerminalSupport::get_DynamicTerminalClasses來探索這些值。
應用程式必須在兩個步驟中取得 pTerminalClassBSTR:呼叫 StringFromIID,將 GUID 轉換成 LPOLESTR,然後呼叫 SysAllocString,將 LPOLESTR 轉換成 BSTR。
應用程式必須使用 SysFreeString 來釋放配置給 pTerminalClass 參數的記憶體。
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | termmgr.h |