IDXGISwapChain1::SetBackgroundColor 메서드(dxgi1_2.h)

스왑 체인의 배경색을 변경합니다.

구문

HRESULT SetBackgroundColor(
  [in] const DXGI_RGBA *pColor
);

매개 변수

[in] pColor

설정할 배경색을 지정하는 DXGI_RGBA 구조체에 대한 포인터입니다.

반환 값

SetBackgroundColor는 다음을 반환합니다.

• 배경색을 성공적으로 설정했는지 S_OK.
• E_INVALIDARG pColor 매개 변수가 올바르지 않은 경우(예: pColor가 NULL이거나 pColor 점이 0.0에서 1.0까지 범위를 벗어나는 DXGI_RGBA 멤버의 부동 소수점 값입니다.
• DXGI_ERROR 항목에 설명된 다른 오류 코드일 수 있습니다.

Windows 7용 플랫폼 업데이트: Windows 7용 플랫폼 업데이트 가 설치된 Windows 7 또는 Windows Server 2008 R2에서는 SetBackgroundColor 가 E_NOTIMPL 실패합니다. Windows 7용 플랫폼 업데이트에 대한 자세한 내용은 Windows 7용 플랫폼 업데이트를 참조하세요.

설명

배경색은 창 모드에서 DXGI_SCALING_NONE 사용하여 만든 스왑 체인에만 영향을 줍니다. IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow 또는 IDXGIFactory2::CreateSwapChainForComposition에 대한 호출에서 이 값을 전달합니다. 일반적으로 스왑 체인 내용이 대상 창보다 작지 않으면 배경색이 표시되지 않습니다.

배경색을 설정하면 즉시 실현되지 않습니다. IDXGISwapChain1::P resent1 메서드에 대한 다음 호출과 함께 적용됩니다. IDXGISwapChain1::P resent1에 전달하는 DXGI_PRESENT 플래그는 필요한 효과를 달성하는 데 도움이 될 수 있습니다. 예를 들어 SetBackgroundColor를 호출한 다음 Flags 매개 변수가 DXGI_PRESENT_DO_NOT_SEQUENCE 설정된 IDXGISwapChain1::P resent1을 호출하는 경우 스왑 체인의 표시된 내용을 변경하지 않고 배경색만 변경합니다.

IDXGISwapChain1::P resent1 메서드를 호출하여 스왑 체인의 콘텐츠를 표시할 때 IDXGISwapChain1::P resent1은 DXGI_SWAP_CHAIN_DESC1 구조체의 AlphaMode 멤버에 지정된 DXGI_ALPHA_MODE 값을 사용하여 DXGI_RGBA 구조체의 멤버를 처리하는 방법을 결정합니다. 창 투명도를 달성합니다. 예를 들어 AlphaMode 가 DXGI_ALPHA_MODE_IGNORE 경우 IDXGISwapChain1::P resent1 은 DXGI_RGBA 멤버를 무시합니다.

참고 모든 프레젠테이션 데이터와 마찬가지로 선형 색 공간에서 부동 소수점 작업을 수행하는 것이 좋습니다. 데스크톱이 고정 비트 색 깊이 모드인 경우 운영 체제는 선형 색 데이터를 표준 RGB 데이터(sRGB, 감마 2.2 수정된 공간)로 변환하여 화면으로 구성합니다. 자세한 내용은 색 공간에 대한 데이터 변환을 참조하세요.

 

요구 사항

지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dxgi1_2.h
라이브러리	Dxgi.lib

추가 정보

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor