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 멤버를 무시합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | dxgi1_2.h |
| 라이브러리 | Dxgi.lib |