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

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

메서드는 Load 소스 필터가 미디어 파일을 로드하도록 합니다.

구문

HRESULT Load(
  [in] LPCOLESTR           pszFileName,
  [in] const AM_MEDIA_TYPE *pmt
);

매개 변수

[in] pszFileName

열 파일의 이름에 대한 포인터입니다.

[in] pmt

파일의 미디어 형식에 대한 포인터입니다. NULL일 수 있습니다.

반환 값

HRESULT 값을 반환합니다.

설명

이 메서드는 인터페이스를 초기화합니다. 여러 파일을 로드하도록 설계되지 않았으며 첫 번째 호출 후 이 메서드에 대한 호출이 실패합니다.

파일 원본(비동기) 필터의 경우 pszFileName은 로컬 파일의 절대 경로 이름을 지정합니다. 파일 원본(URL) 필터의 경우 pszFileName은 다운로드할 파일의 URL을 지정합니다. 다른 필터 구현의 경우 pszFileName 에는 필터에 따라 파일 이름 또는 URL이 필요할 수 있습니다.

요구 사항

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

추가 정보

오류 및 성공 코드

IFileSourceFilter 인터페이스