IMFASFProfile::GetStream 메서드(wmcontainer.h)

아티클
03/13/2024

스트림 인덱스별로 프로필에서 스트림을 검색하고 스트림 인덱스에 대한 스트림 번호를 검색합니다.

구문

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

매개 변수

[in] dwStreamIndex

검색할 스트림의 인덱스입니다. Stream 인덱스는 순차적이고 0부터 시작합니다. IMFASFProfile::GetStreamCount 메서드를 호출하여 프로필에 있는 스트림 수를 가져올 수 있습니다.

[out] pwStreamNumber

요청된 스트림의 스트림 번호를 받습니다. Stream 숫자는 1 기반이며 반드시 순차적이지는 않습니다. 스트림 번호가 필요하지 않은 경우 이 매개 변수를 NULL 로 설정할 수 있습니다.

[out] ppIStream

ASF 스트림 구성 개체의 IMFASFStreamConfig 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다. 스트림 구성에 액세스하지 않고 스트림 번호를 검색하려는 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.

설명

이 메서드는 스트림 구성 개체의 복사본을 만들지 않습니다. 검색되는 포인터는 프로필 개체 내의 개체를 가리킵니다. 이렇게 하면 프로필 개체에 예기치 않은 방식으로 영향을 줄 수 있으므로 이 포인터를 사용하여 스트림 구성 개체를 변경하지 않아야 합니다.

프로필에서 스트림 구성 개체의 구성을 변경하려면 먼저 IMFASFStreamConfig::Clone을 호출하여 스트림 구성 개체를 복제해야 합니다. 개체의 복제본에 필요한 변경 내용을 적용한 다음 IMFASFProfile::SetStream 메서드를 호출하여 업데이트된 개체를 추가합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wmcontainer.h
라이브러리	Mfuuid.lib