IAMFilterGraphCallback::UnableToRender 메서드(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
UnableToRender 지정된 핀을 렌더링하는 필터 조합을 찾을 수 없는 경우 Filter Graph Manager에서 메서드를 호출합니다.
구문
HRESULT UnableToRender(
IPin *pPin
);
매개 변수
pPin
렌더링할 수 없는 핀의 IPin 인터페이스를 지정합니다.
반환 값
반환 값이 S_OK 경우 이 필터 그래프 관리자는 핀을 다시 렌더링하려고 시도합니다. S_FALSE 및 기타 성공 코드를 포함한 다른 반환 값의 경우 Filter Graph Manager는 그래프를 정상적으로 빌드합니다. 일반적으로 현재 필터를 거부하고 다른 필터를 사용하려고 시도합니다.
설명
Filter Graph Manager는 이 메서드를 호출하는 동안 그래프 전체의 중요 섹션을 보유합니다. 따라서 콜백 메서드는 Filter Graph Manager에서 메서드 또는 그래프 상태를 변경할 수 있는 필터의 메서드(예: 핀 연결 끊기)를 호출하지 않아야 합니다. 이렇게 하면 교착 상태 또는 기타 예기치 않은 동작이 발생할 수 있습니다. 그러나 인터페이스에 대한 핀을 쿼리하거나 핀의 기본 미디어 형식을 검사 것이 안전합니다. 이 메서드에 사용할 기본 디코더와 같은 새 필터를 등록하는 것입니다.
이 메서드는 __stdcall 대신 이 호출 호출 규칙을 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |
| 라이브러리 | Strmiids.lib |