CBaseControlWindow.GetMaxIdealImageSize 메서드
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
메서드는 GetMaxIdealImageSize 최대 이상적인 이미지 크기를 검색합니다.
구문
HRESULT GetMaxIdealImageSize(
long *pWidth,
long *pHeight
);
매개 변수
-
pWidth
-
최대 이상적인 너비(픽셀)에 대한 포인터입니다.
-
pHeight
-
최대 이상적인 높이(픽셀)에 대한 포인터입니다.
반환 값
HRESULT 값을 반환합니다.
설명
다양한 렌더러에는 표시할 수 있는 이미지의 크기에 대한 성능 제한이 있습니다. 지정된 최대값보다 큰 이미지를 표시하도록 요청된 경우에도 제대로 작동해야 하지만 렌더러가 IVideoWindow 인터페이스를 통해 최소 및 최대 이상적인 크기를 지정할 수 있습니다. 이 인터페이스는 필터 그래프가 일시 중지되거나 실행될 때만 호출할 수 있습니다. 그 때까지는 리소스가 할당되고 렌더러가 제한을 인식할 수 있기 때문입니다. 제한이 없는 경우 렌더러는 pWidth 및 pHeight 매개 변수를 네이티브 비디오 차원으로 채우고 S_FALSE 반환합니다. 제한이 있으면 제한된 너비와 높이가 입력되고 멤버 함수는 S_OK 반환합니다.
차원은 전체 창 크기가 아닌 대상 비디오의 크기에 적용됩니다. 따라서 설정할 창의 크기를 계산할 때 현재 창 스타일(예: WS_CAPTION 및 WS_BORDER)을 고려합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|