IVideoWindow::p ut_BackgroundPalette 메서드(control.h)

  • 아티클

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

메서드는 put_BackgroundPalette 비디오 창이 배경에서 색상표를 실현하는지 여부를 지정합니다.

구문

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

매개 변수

[in] BackgroundPalette

비디오 렌더러가 배경에서 색상표를 인식할지 여부를 지정합니다. 다음 값 중 하나여야 합니다.

값 Description
오트루 비디오 렌더러는 배경에서 팔레트를 인식합니다.
OAFALSE 비디오 렌더러는 배경에서 팔레트를 인식하지 못합니다. 이 속성의 기본값입니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
 인수가 잘못되었습니다.
S_OK
 성공.
VFW_E_NOT_CONNECTED
 비디오 렌더러 필터가 연결되지 않았습니다.

설명

BackgroundPalette가 OATRUE이고 비디오 이미지에 색상표가 필요한 경우 비디오 렌더러는 배경에서 해당 팔레트를 인식합니다. 색상표에서 사용하는 모든 색은 그리기 전에 디스플레이 색상표에서 가장 가까운 일치 항목으로 변경됩니다. 이렇게 하면 애플리케이션의 색상표가 방해받지 않습니다. 그러나 비디오에 심각한 성능 페널티를 부과합니다.

요구 사항

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

추가 정보

오류 및 성공 코드

IVideoWindow 인터페이스

IVideoWindow::get_BackgroundPalette