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 インターフェイスへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

備考

pTerminalClassの値を選択する場合、使用できる唯一のターミナル クラス GUID は、"動的に" 作成されるターミナルに対応する GUID です。 たとえば、TAPI3 で現在定義されているすべてのターミナル クラスから、CreateTerminal: CLSID_MediaStreamTerminalとCLSID_VideoWindowTermで使用できるのは次だけです。

さらに、このアドレスでサポートされている動的ターミナル クラスのみを使用できます。 アプリケーションは、ITTerminalSupport::EnumerateDynamicTerminalClasses または ITTerminalSupport::get_DynamicTerminalClassesを使用して、これらの値を検出できます。

アプリケーションは、pTerminalClassBSTR を 2 つの手順で取得する必要があります。StringFromIID を呼び出して GUID を LPOLESTRに変換した後、sysAllocString 呼び出して、LPOLESTR を BSTRに変換します。

pTerminalClass パラメーターに割り当てられたメモリを解放するには、アプリケーション SysFreeString を使用する必要があります。

必要条件

関連項目

ITTerminalManager の

TERMINAL_DIRECTION

メディアの種類 を する