IRenderEngine::SetSourceNameValidation 메서드
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
참고
[더 이상 사용되지 않습니다. 이 API는 이후 Windows 릴리스에서 제거될 수 있습니다.]
메서드는 SetSourceNameValidation 렌더링 엔진이 파일 이름의 유효성을 검사하는 방법을 지정합니다.
구문
HRESULT SetSourceNameValidation(
BSTR FilterString,
IMediaLocator *pOverride,
LONG Flags
);
매개 변수
-
FilterString
-
OPENFILENAME 구조체의 lpstrFilter 멤버에 필요한 형식으로 지정된 필터 문자열 쌍을 포함하는 BSTR 값입니다. 미디어 로케이터는 최종 사용자에게 파일 열기 대화 상자를 표시하는 경우 이 필터를 사용합니다.
-
pOverride
-
기본값 대신 사용할 미디어 로케이 터의 IMediaLocator 인터페이스에 대한 선택적 포인터입니다. 기본 미디어 로케이터를 사용하려면 이 매개 변수의 값을 NULL로 설정합니다. 자세한 내용은 설명 부분을 참조하십시오.
-
플래그
-
미디어 로케이터의 동작을 지정하는 파일 이름 유효성 검사 플래그 의 비트 조합입니다. SFN_VALIDATEF_CHECK 플래그가 있어야 합니다. SFN_VALIDATEF_hlinkMUTED 플래그는 이 메서드에 영향을 주지 않습니다.
반환 값
다음 HRESULT 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
렌더링 엔진을 초기화하지 못했습니다. |
설명
pOverride 매개 변수를 사용하여 IMediaLocator 인터페이스의 사용자 지정 구현을 직접 제공할 수 있습니다. 예를 들어 기본 미디어 로케이터는 애플리케이션이 찾거나 찾을 수 없는 파일에 대해 알리지 않습니다. 이 제한을 해결하려면 사용자 지정 미디어 로케이터를 구현하여 기본 버전의 래퍼로 만들 수 있습니다. 그런 다음 IMediaLocator::FindMediaFile 호출을 기본 버전으로 직접 전달하고 반환 값을 검사합니다.
현재 이 메서드는 동적으로 로드된 원본의 유효성을 검사하지 않습니다. IRenderEngine::SetDynamicReconnectLevel을 참조하세요.
참고
헤더 파일 Qedit.h는 버전 7 이후의 Direct3D 헤더와 호환되지 않습니다.
참고
Qedit.h를 얻으려면 Windows Vista용 Microsoft Windows SDK 업데이트를 다운로드하고 3.0을 .NET Framework. Qedit.h는 Windows 7 및 .NET Framework 3.5 서비스 팩 1용 Microsoft Windows SDK 사용할 수 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보