ITStreamControl::CreateStream 메서드(tapi3if.h)

CreateStream 메서드는 새 미디어 스트림을 만듭니다.

구문

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

[in] lMediaType

스트림의 미디어 형식 을 나타냅니다.

[in] td

[out] ppStream

새로 만든 ITStream 인터페이스에 대한 포인터입니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	의미
S_OK	메서드가 정상적으로 실행되었습니다.
E_POINTER	ppStream 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 수행할 수 없습니다.
TAPI_E_INVALIDMEDIATYPE	lMediaType 매개 변수가 유효한 미디어 형식이 아닙니다.
TAPI_E_INVALIDDIRECTION	td 매개 변수가 유효한 터미널 방향이 아닙니다.
TAPI_E_MAXSTREAMS	지원되는 최대 스트림 수에 이미 도달했습니다.
TAPI_E_NOTSUPPORTED	이 작업은 지원되지 않습니다.

많은 MSP는 스트림의 동적 생성을 지원하지 않으며 단순히 이 메서드의 구현에서 TAPI_E_MAXSTREAMS 반환합니다. 호출을 만들 때 기본 스트림을 자동으로 사용할 수 있으므로 대부분의 애플리케이션에서 이 메서드를 사용할 필요가 없습니다.

스트림 만들기 또는 제거에는 원격 엔드포인트와의 상호 작용이 포함될 수 있으므로 스트림이 중지되거나 시작될 때 수신되는 CMC_LOCAL_REQUEST 메시지가 아닌 CMC_REMOTE_REQUEST 발생할 수 있습니다.

TAPI는 ITStreamControl::CreateStream에서 반환된 ITStream 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITStream 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.


대상 플랫폼	Windows
헤더	tapi3if.h(Tapi3.h 포함)