Share via

CBaseControlWindow.GetMinIdealImageSize 메서드

  • 아티클

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

메서드는 GetMinIdealImageSize 이상적인 최소 이미지 크기를 검색합니다.

구문

HRESULT GetMinIdealImageSize(
   long *pWidth,
   long *pHeight
);

매개 변수

pWidth

최소 이상적인 너비(픽셀)에 대한 포인터입니다.

pHeight

최소 이상적인 높이(픽셀)에 대한 포인터입니다.

반환 값

HRESULT 값을 반환합니다.

설명

다양한 렌더러에는 표시할 수 있는 이미지의 크기에 대한 성능 제한이 있습니다. 지정된 최대값보다 큰 이미지를 표시하도록 요청된 경우에도 제대로 작동해야 하지만 렌더러가 IVideoWindow 인터페이스를 통해 최소 및 최대 이상적인 크기를 지정할 수 있습니다. 이 인터페이스는 필터 그래프가 일시 중지되거나 실행될 때만 호출할 수 있습니다. 그 때까지는 리소스가 할당되고 렌더러가 해당 제한을 인식할 수 있기 때문입니다. 제한이 없으면 렌더러는 pWidth 및 pHeight 매개 변수를 네이티브 비디오 차원으로 채우고 S_FALSE 반환합니다. 제한이 있는 경우 제한된 너비와 높이가 입력되고 멤버 함수는 S_OK 반환합니다.

차원은 전체 창 크기가 아닌 대상 비디오의 크기에 적용됩니다. 따라서 설정할 창의 크기를 계산할 때 현재 창 스타일(예: WS_CAPTION 및 WS_BORDER)을 고려합니다.

요구 사항

요구 사항 값
헤더
Ctlutil.h(Streams.h 포함)
라이브러리
Strmbase.lib(소매 빌드);
Strmbasd.lib(디버그 빌드)

추가 정보

CBaseControlWindow 클래스