DXGI_SWAP_CHAIN_FLAG (XBOX Series 主機)

交換鏈行為的選項。

語法

typedef enum DXGI_SWAP_CHAIN_FLAG    
{  
    DXGI_SWAP_CHAIN_FLAG_NONPREROTATED = 1,  
    DXGI_SWAP_CHAIN_FLAG_ALLOW_MODE_SWITCH = 2,  
    DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE = 4,  
    DXGI_SWAP_CHAIN_FLAG_RESTRICTED_CONTENT = 8,  
    DXGI_SWAP_CHAIN_FLAG_RESTRICT_SHARED_RESOURCE_DRIVER = 16,  
    DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY = 32,  
    DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL = 0,  
    DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_LIMITED = 0x00100000,  
    DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709 = 0x00200000,  
    DXGIX_SWAP_CHAIN_MATCH_OTHER_CONSOLES = ( DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL ),  
    DXGIX_SWAP_CHAIN_MATCH_XBOX360_AND_PC = ( DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL | DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709 ),  
    DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_RGB_BT2020_ST2084 = 0x00800000,  
    DXGIX_SWAP_CHAIN_FLAG_AUTOMATIC_GAMEDVR_TONEMAP = 0x02000000,  
} DXGI_SWAP_CHAIN_FLAG  

常數

常數	描述
DXGI_SWAP_CHAIN_FLAG_NONPREROTATED	設定此旗標可關閉自動影像旋轉；也就是說，將前景緩衝區的內容傳輸至螢幕時不執行旋轉。
當應用程式預期自行處理旋轉時，請使用此旗標以避免頻寬損失。此選項只在全螢幕模式下有效。
DXGI_SWAP_CHAIN_FLAG_ALLOW_MODE_SWITCH	設定此旗標可讓應用程式藉由呼叫 IDXGISwapChain::ResizeTarget 來切換模式。
從視窗模式切換至全螢幕模式時，顯示模式 (或螢幕解析度) 會變更為符合應用程式視窗的尺寸。
DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE	設定此旗標可讓應用程式在交換鏈或表面上使用 GDI 進行轉譯。這可讓應用程式在第 0 個背景緩衝區或表面上呼叫 IDXGISurface1::GetDC。此旗標不適用於 Direct3D 12。
DXGI_SWAP_CHAIN_FLAG_RESTRICTED_CONTENT	設定此旗標以指出交換鏈可能包含受保護的內容；因此，作業系統只有在使用驅動程式和硬體保護時，才支援建立交換鏈。如果驅動程式和硬體不支援內容保護，為交換鏈建立資源的呼叫就會失敗。 Direct3D 11: 從 Windows 8 開始支援此列舉值。
DXGI_SWAP_CHAIN_FLAG_RESTRICT_SHARED_RESOURCE_DRIVER	設定此旗標以指出在交換鏈內建立的共用資源，必須使用驅動程式限制存取共用表面的機制來加以保護。 Direct3D 11: 從 Windows 8 開始支援此列舉值。
DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY	設定此旗標可將呈現的內容限制在本機顯示器上。因此，無法透過遠端存取或桌面複製 API 存取呈現的內容。此旗標支援 Windows 的視窗內容保護功能。應用程式可以使用此旗標，保護自己的螢幕視窗內容不會透過一組特定的公用作業系統功能和 API 遭到擷取或複製。如果您將此旗標用於由其他處理序建立 HWND 的視窗型 (HWND 或 IWindow) 交換鏈，則 HWND 的擁有者必須適當地使用 SetWindowDisplayAffinity 函式，才能讓 IDXGISwapChain::Present 或 IDXGISwapChain1::Present1 的呼叫成功。 Direct3D 11: 從 Windows 8 開始支援此列舉值。
DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL	已淘汰
DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_LIMITED	已淘汰
DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709	已淘汰
DXGIX_SWAP_CHAIN_MATCH_OTHER_CONSOLES	已淘汰
DXGIX_SWAP_CHAIN_MATCH_XBOX360_AND_PC	已淘汰
DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_RGB_BT2020_ST2084	已淘汰
DXGIX_SWAP_CHAIN_FLAG_AUTOMATIC_GAMEDVR_TONEMAP	已淘汰

備註

此列舉由 DXGI_SWAP_CHAIN_DESC 結構和 IDXGISwapChain::ResizeTarget 方法使用。此列舉也由 DXGI_SWAP_CHAIN_DESC1 結構使用。對於使用 IDXGIFactory::CreateSwapChain 方法以全螢幕模式建立的交換鏈，您不需要設定 DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY，因為這些交換鏈的行為已如同設定了 DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY。也就是說，無法透過遠端存取或桌面複製 API 存取呈現的內容。使用 IDXGIFactory2::CreateSwapChainForHwnd、IDXGIFactory2::CreateSwapChainForCoreWindow 和 IDXGIFactory2::CreateSwapChainForComposition 方法建立的交換鏈，若未設定 DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY 則不受保護，若設定了 DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY 則受到保護。當交換鏈受到保護時，會防止螢幕擷取，而且在全螢幕模式下，無法透過桌面複製 API 存取呈現的內容。當您呼叫 IDXGISwapChain::ResizeBuffers 來變更交換鏈的背景緩衝區時，可以重設或變更所有 DXGI_SWAP_CHAIN_FLAG 旗標。

需求

標頭: d3d12_xs.h
支援的平台: XBOX Series 主機

另請參閱

d3d12_xs

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

語法

常數

備註

需求

另請參閱

​語法

​常數

​備註

​需求

​另請參閱

語法

常數

備註

需求

另請參閱