IMFASFStreamConfig::GetPayloadExtension 메서드(wmcontainer.h)

  • 아티클

기존 페이로드 확장에 대한 정보를 검색합니다.

구문

HRESULT GetPayloadExtension(
  [in]      WORD  wPayloadExtensionNumber,
  [out]     GUID  *pguidExtensionSystemID,
  [out]     WORD  *pcbExtensionDataSize,
  [out]     BYTE  *pbExtensionSystemInfo,
  [in, out] DWORD *pcbExtensionSystemInfo
);

매개 변수

[in] wPayloadExtensionNumber

페이로드 확장 인덱스입니다. 유효한 인덱스 범위는 0에서 IMFASFStreamConfig::GetPayloadExtensionCount를 호출하여 얻은 확장 수보다 1보다 작습니다.

[out] pguidExtensionSystemID

페이로드 확장을 식별하는 GUID를 받습니다. 미리 정의된 페이로드 확장 목록은 ASF 페이로드 확장 GUID를 참조하세요. 애플리케이션은 사용자 지정 페이로드 확장을 정의할 수도 있습니다.

[out] pcbExtensionDataSize

확장에 대한 각 샘플에 추가된 바이트 수를 받습니다.

[out] pbExtensionSystemInfo

이 확장 시스템에 대한 정보를 수신하는 버퍼에 대한 포인터입니다. 이 정보는 모든 샘플에 대해 동일하며 각 샘플이 아닌 콘텐츠 헤더에 저장됩니다. 이 매개 변수는 NULL일 수 있습니다. 버퍼의 필요한 크기를 찾으려면 이 매개 변수를 NULL로 설정합니다. 크기는 pcbExtensionSystemInfo에서 반환됩니다.

[in, out] pcbExtensionSystemInfo

입력에서 pbExtensionSystemInfo가 가리키는 버퍼의 크기를 지정합니다. 출력 시 pbExtensionSystemInfo 버퍼의 필요한 크기(바이트)를 받습니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_INVALIDARG
 인수가 잘못되었습니다.
MF_E_BUFFERTOOSMALL
 pbExtensionSystemInfo에 지정된 버퍼가 너무 작습니다.
MF_E_INVALIDINDEX
 wPayloadExtensionNumber 매개 변수가 범위를 벗어났습니다.

요구 사항

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

추가 정보

IMFASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount