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

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

메서드는 GetCurFile 현재 파일의 이름 및 미디어 형식을 검색합니다.

구문

HRESULT GetCurFile(
  [out] LPOLESTR      *ppszFileName,
  [out] AM_MEDIA_TYPE *pmt
);

매개 변수

[out] ppszFileName

파일 이름을 OLESTR 형식으로 받는 포인터의 주소입니다.

[out] pmt

미디어 형식을 수신하는 AM_MEDIA_TYPE 구조체에 대한 포인터입니다. 이 매개 변수는 NULL에 의해 가능하며, 이 경우 메서드는 미디어 형식을 반환하지 않습니다.

반환 값

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

반환 코드	Description
S_OK	성공.
E_FAIL	파일이 열려 있지 않습니다.
E_OUTOFMEMORY	메모리가 부족합니다.
E_POINTER	ppszFileName의 NULL 포인터 인수입니다.

설명

필터가 파일을 열지 않은 경우 메서드는 성공하지만 ppszFileName 매개 변수에서 NULL을 반환할 수 있습니다. 메서드가 반환되는 경우 값을 확인합니다.

메서드는 ppszFileName에서 반환된 문자열의 메모리와 미디어 형식의 형식 블록에 대한 메모리(있는 경우)를 할당합니다. 호출자는 CoTaskMemFree를 호출하여 해제해야 합니다. 미디어 형식의 경우 기본 클래스 라이브러리에서 FreeMediaType 함수를 사용할 수 있습니다.

요구 사항

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

추가 정보

오류 및 성공 코드

IFileSourceFilter 인터페이스