Metodo ITTerminalManager::CreateDynamicTerminal (termmgr.h)

Articolo
07/16/2024

Il metodo CreateDynamicTerminal crea un terminale dinamico di una classe terminale, un tipo di supporto e una direzione specificati.

Sintassi

HRESULT CreateDynamicTerminal(
  [in]  IUnknown           *pOuterUnknown,
  [in]  IID                iidTerminalClass,
  [in]  DWORD              dwMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [in]  MSP_HANDLE         htAddress,
  [out] ITTerminal         **ppTerminal
);

Parametri

[in] pOuterUnknown

Se MSP aggrega l'oggetto terminale, impostare il puntatore all'interfaccia IUnknown per l'oggetto MSP. In genere è impostato su NULL.

[in] iidTerminalClass

GUID che identifica la classe del terminale da creare.

[in] dwMediaType

Descrittore di tipo di supporto per il flusso.

[in] Direction

TERMINAL_DIRECTION descrittore della direzione del flusso multimediale per il terminale.

[in] htAddress

Handle MSP.

[out] ppTerminal

Puntatore a interfaccia ITTerminal per il nuovo terminale.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Metodo riuscito.
E_INVALIDARG	Il parametro fMessageWaiting non è valido.
E_POINTER	Il parametro ppAddress non è un puntatore valido.

Osservazioni

Quando si sceglie un valore per pTerminalClass, gli unici GUID della classe terminale che possono essere usati sono quelli che corrispondono ai terminali creati in modo "dinamico". Ad esempio, da tutte le classi del terminale attualmente definite da TAPI3, è possibile usare solo gli elementi seguenti con CreateTerminal: CLSID_MediaStreamTerminal e CLSID_VideoWindowTerm.

Inoltre, è possibile usare solo le classi del terminale dinamiche supportate in questo indirizzo. L'applicazione può individuare questi valori usando ITTerminalSupport::EnumerateDynamicTerminalClasses o ITTerminalSupport::get_DynamicTerminalClasses.

L'applicazione deve ottenere pTerminalClassBSTR in due passaggi: chiamare StringFromIID per convertire il GUID in un LPOLESTR, quindi chiamare SysAllocString per convertire il LPOLESTR in un BSTR .

L'applicazione deve usare SysFreeString per liberare la memoria allocata per il parametro pTerminalClass .