From cb342ee0f1275bd3fb35aa8bf0a1ef618b750411 Mon Sep 17 00:00:00 2001
From: Filippo Tarpini <filippotarpini@hotmail.it>
Date: Thu, 30 Jan 2025 21:46:58 +0200
Subject: [PATCH 1/2] Flip model is required for HDR

---
 sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md b/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md
index 2a5a8e0a7475..2c0e84098b7b 100644
--- a/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md
+++ b/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md
@@ -123,6 +123,9 @@ When you call <a href="/windows/win32/api/dxgi1_2/nf-dxgi1_2-idxgiswapchain1-pre
 Regardless of whether the flip model is more efficient, an application still might choose the bitblt model because the bitblt model is the only way to mix GDI and DirectX presentation. In the flip model, the application must create the swap chain with <a href="/windows/win32/api/dxgi/ne-dxgi-dxgi_swap_chain_flag">DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE</a>, and then must use <a href="/windows/win32/api/dxgi/nf-dxgi-idxgisurface1-getdc">GetDC</a> on the back buffer explicitly. After the first successful call to <a href="/windows/win32/api/dxgi1_2/nf-dxgi1_2-idxgiswapchain1-present1">IDXGISwapChain1::Present1</a> on a flip-model swap chain, GDI no longer works with the <a href="/windows/win32/WinProg/windows-data-types">HWND</a> that is associated with that swap chain, even after the destruction of the swap chain. This restriction even extends to methods like <a href="/windows/win32/api/winuser/nf-winuser-scrollwindowex">ScrollWindowEx</a>.
         
 
+Flip modes are required to display HDR swapchain buffer formats and color spaces, otherwise they get composed (and clipped) in SDR (sRGB with a 0-1 range).
+        
+
 For more info about the flip-model swap chain and optimizing presentation, see <a href="/windows/win32/direct3ddxgi/dxgi-1-2-presentation-improvements">Enhancing presentation with the flip model, dirty rectangles, and scrolled areas</a>.
         
 

From e99d98c1570945c5a28469f2c60aff192ad59c3a Mon Sep 17 00:00:00 2001
From: Steven White <31261191+stevewhims@users.noreply.github.com>
Date: Thu, 30 Jan 2025 12:12:49 -0800
Subject: [PATCH 2/2] Rephrase HDR swapchain buffer format requirement

---
 sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md b/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md
index 2c0e84098b7b..0520fed9bf98 100644
--- a/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md
+++ b/sdk-api-src/content/dxgi/ne-dxgi-dxgi_swap_effect.md
@@ -123,7 +123,7 @@ When you call <a href="/windows/win32/api/dxgi1_2/nf-dxgi1_2-idxgiswapchain1-pre
 Regardless of whether the flip model is more efficient, an application still might choose the bitblt model because the bitblt model is the only way to mix GDI and DirectX presentation. In the flip model, the application must create the swap chain with <a href="/windows/win32/api/dxgi/ne-dxgi-dxgi_swap_chain_flag">DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE</a>, and then must use <a href="/windows/win32/api/dxgi/nf-dxgi-idxgisurface1-getdc">GetDC</a> on the back buffer explicitly. After the first successful call to <a href="/windows/win32/api/dxgi1_2/nf-dxgi1_2-idxgiswapchain1-present1">IDXGISwapChain1::Present1</a> on a flip-model swap chain, GDI no longer works with the <a href="/windows/win32/WinProg/windows-data-types">HWND</a> that is associated with that swap chain, even after the destruction of the swap chain. This restriction even extends to methods like <a href="/windows/win32/api/winuser/nf-winuser-scrollwindowex">ScrollWindowEx</a>.
         
 
-Flip modes are required to display HDR swapchain buffer formats and color spaces, otherwise they get composed (and clipped) in SDR (sRGB with a 0-1 range).
+To display HDR swapchain buffer formats and color spaces, a flip model is required. Otherwise they get composed (and clipped) in SDR (sRGB with a 0-1 range).
         
 
 For more info about the flip-model swap chain and optimizing presentation, see <a href="/windows/win32/direct3ddxgi/dxgi-1-2-presentation-improvements">Enhancing presentation with the flip model, dirty rectangles, and scrolled areas</a>.