共用方式為

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 介面的指標。

傳回值

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

價值 意義
S_OK
 方法成功。
E_INVALIDARG
 fMessageWaiting 參數無效。
E_POINTER
 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

另請參閱

ITTerminalManager

TERMINAL_DIRECTION

媒體類型