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는 "동적으로" 만들어진 터미널에 해당하는 GUID입니다. 예를 들어 현재 TAPI3에서 정의된 모든 터미널 클래스에서 CreateTerminal에는 CLSID_MediaStreamTerminal 및 CLSID_VideoWindowTerm 사용할 수 있습니다.

또한 이 주소에서 지원되는 동적 터미널 클래스만 사용할 수 있습니다. 애플리케이션은 ITTerminalSupport::EnumerateDynamicTerminalClasses 사용하거나 ITTerminalSupport::get_DynamicTerminalClasses이러한 값을 검색할 수 있습니다.

애플리케이션은 두 단계로 pTerminalClassBSTR 가져와야 합니다. StringFromIID 호출하여 GUID를 LPOLESTR변환한 다음, SysAllocString 호출하여 LPOLESTRBSTR변환합니다.

애플리케이션은 sysFreeString 사용하여 pTerminalClass 매개 변수에 할당된 메모리를 해제해야 합니다.

요구 사항

요구	값
대상 플랫폼	Windows
헤더	termmgr.h

참고 항목

ITTerminalManager

TERMINAL_DIRECTION

미디어 형식