다음을 통해 공유

IPersistMediaPropertyBag::Load 메서드(strmif.h)

  • 아티클

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 Load 미디어 속성 모음에서 필터로 속성을 로드합니다.

구문

HRESULT Load(
  [in] IMediaPropertyBag *pPropBag,
  [in] IErrorLog         *pErrorLog
);

매개 변수

[in] pPropBag

호출자가 만든 미디어 속성 모음의 IMediaPropertyBag 인터페이스에 대한 포인터입니다.

[in] pErrorLog

예약되어 있습니다. 값을 NULL로 설정합니다.

반환 값

HRESULT 값을 반환합니다. 가능한 값은 다음과 같습니다.

반환 코드 Description
S_OK
 성공.
E_POINTER
 NULL 포인터 인수입니다.
STG_E_ACCESSDENIED
 액세스가 거부되었습니다.
VFW_E_WRONG_STATE
 필터 그래프가 중지된 상태가 아닙니다.

설명

AVI Mux 필터에서 이 메서드를 호출하여 속성을 AVI 스트림에 씁니다. 필터 그래프를 실행하여 파일을 작성하기 전에 필터가 중지되면 메서드를 호출합니다. 그래프가 실행되면 필터는 INFO 청크를 AVI 헤더에 씁니다.

다음 코드 예제에서는 IART(작성자 이름) INFO 청크를 파일에 추가합니다.

C++ 
IPersistMediaPropertyBag *pPersist = NULL; IMediaPropertyBag *pBag = NULL; VARIANT val;
IPersistMediaPropertyBag에 대한 AVI Mux 필터를 쿼리합니다(표시되지 않음).


CoCreateInstance(CLSID_MediaPropertyBag, NULL, CLSCTX_INPROC, IID_IMediaPropertyBag(LPVOID *)&pBag);


val.vt = VT_BSTR;
val.bstrVal = SysAllocString(OLESTR("Author Name"));
pBag->Write(OLESTR("INFO/IART"), &val);
pPersist->Load(pBag, NULL);
VariantClear(&val);

AVI 분할기 필터 및 WAVE 파서는 이 메서드를 지원하지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 strmif.h(Dshow.h 포함)
라이브러리 Strmiids.lib

추가 정보

오류 및 성공 코드

IPersistMediaPropertyBag 인터페이스