struttura DXGI_SWAP_CHAIN_DESC1 (dxgi1_2.h)

Descrive una catena di scambio.

Sintassi

typedef struct DXGI_SWAP_CHAIN_DESC1 {
  UINT             Width;
  UINT             Height;
  DXGI_FORMAT      Format;
  BOOL             Stereo;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  DXGI_SCALING     Scaling;
  DXGI_SWAP_EFFECT SwapEffect;
  DXGI_ALPHA_MODE  AlphaMode;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC1;

Members

Width

Valore che descrive la larghezza della risoluzione. Se si specifica la larghezza come zero quando si chiama il metodo IDXGIFactory2::CreateSwapChainForHwnd per creare una catena di scambio, il runtime ottiene la larghezza dalla finestra di output e assegna questo valore di larghezza alla descrizione della catena di scambio. Successivamente puoi chiamare il metodo IDXGISwapChain1::GetDesc1 per recuperare il valore di larghezza assegnato. Non è possibile specificare la larghezza come zero quando si chiama il metodo IDXGIFactory2::CreateSwapChainForComposition .

Height

Valore che descrive l'altezza della risoluzione. Se si specifica l'altezza come zero quando si chiama il metodo IDXGIFactory2::CreateSwapChainForHwnd per creare una catena di scambio, il runtime ottiene l'altezza dalla finestra di output e assegna questo valore di altezza alla descrizione della catena di scambio. Successivamente puoi chiamare il metodo IDXGISwapChain1::GetDesc1 per recuperare il valore di altezza assegnato. Non è possibile specificare l'altezza come zero quando si chiama il metodo IDXGIFactory2::CreateSwapChainForComposition .

Format

Struttura DXGI_FORMAT che descrive il formato di visualizzazione.

Stereo

Specifica se la modalità di visualizzazione a schermo intero o il buffer back della catena di scambio è stereo. TRUE se stereo; in caso contrario, FALSE. Se si specifica stereo, è necessario specificare anche una catena di scambio del modello capovolgimento, ovvero una catena di scambio con il valore DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL impostato nel membro SwapEffect .

SampleDesc

Struttura DXGI_SAMPLE_DESC che descrive i parametri di campionamento multipla. Questo membro è valido solo con catene di scambio del modello bit-block transfer (bitblt).

BufferUsage

Valore tipizzato DXGI_USAGE che descrive l'utilizzo della superficie e le opzioni di accesso alla CPU per il buffer nascosto. Il buffer nascosto può essere usato per l'input dello shader o l'output di destinazione di rendering.

BufferCount

Valore che descrive il numero di buffer nella catena di scambio. Quando si crea una catena di scambio a schermo intero, in genere si include il buffer anteriore in questo valore.

Scaling

Valore tipizzato DXGI_SCALING che identifica il comportamento di ridimensionamento se le dimensioni del buffer nascosto non sono uguali all'output di destinazione.

SwapEffect

Valore tipizzato DXGI_SWAP_EFFECT che descrive il modello di presentazione utilizzato dalla catena di scambio e le opzioni per la gestione del contenuto del buffer di presentazione dopo la presentazione di una superficie. È necessario specificare il valore DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL quando si chiama il metodo IDXGIFactory2::CreateSwapChainForComposition perché questo metodo supporta solo il modello di presentazione capovolto.

AlphaMode

Valore tipizzato DXGI_ALPHA_MODE che identifica il comportamento di trasparenza del buffer back della catena di scambio.

Flags

Combinazione di valori tipizzati DXGI_SWAP_CHAIN_FLAG combinati tramite un'operazione OR bit per bit. Il valore risultante specifica le opzioni per il comportamento della catena di scambio.

Commenti

Questa struttura viene usata dai metodi CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle e GetDesc1 .

Nota Non è possibile eseguire il cast di un DXGI_SWAP_CHAIN_DESC1 a un DXGI_SWAP_CHAIN_DESC e viceversa. Un'applicazione deve usare in modo esplicito il metodo IDXGISwapChain1::GetDesc1 per recuperare la versione più recente della struttura di descrizione della catena di scambio.

 

In modalità schermo intero è presente un buffer anteriore dedicato; in modalità finestra, il desktop è il buffer anteriore.

Per una catena di scambio del modello capovolgimento,ovvero una catena di scambio con il valore DXGI_SWAP_EFFECT_FLIP_DISCARD o DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL impostato nel membro SwapEffect , è necessario impostare il membro Format su DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM o DXGI_FORMAT_R10G10B10A10_UNORM; è necessario impostare il membro Count della struttura DXGI_SAMPLE_DESC che il membro SampleDesc specifica su uno e il membro Quality di DXGI_SAMPLE_DESC su zero perché l'anti-aaliasing di esempio multiplo (MSAA) non è supportato; è necessario impostare il membro BufferCount su da due a sedici. Per altre info sulla catena di scambio del modello flip-model, vedi DXGI Flip Model.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Intestazione	dxgi1_2.h

Vedi anche

Strutture DXGI

IDXGISwapChain1::GetDesc1