struttura DXGI_SWAP_CHAIN_DESC (dxgi.h)

Descrive una catena di scambio.

Sintassi

typedef struct DXGI_SWAP_CHAIN_DESC {
  DXGI_MODE_DESC   BufferDesc;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  HWND             OutputWindow;
  BOOL             Windowed;
  DXGI_SWAP_EFFECT SwapEffect;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC;

Members

BufferDesc

Tipo: DXGI_MODE_DESC

Struttura DXGI_MODE_DESC che descrive la modalità di visualizzazione backbuffer.

SampleDesc

Tipo: DXGI_SAMPLE_DESC

Struttura DXGI_SAMPLE_DESC che descrive i parametri di campionamento multipla.

BufferUsage

Tipo: DXGI_USAGE

Membro del tipo enumerato 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

Tipo: UINT

Valore che descrive il numero di buffer nella catena di scambio. Quando chiami IDXGIFactory::CreateSwapChain per creare una catena di scambio a schermo intero, in genere includi il buffer anteriore in questo valore. Per altre informazioni sui buffer della catena di scambio, vedere Osservazioni.

OutputWindow

Tipo: HWND

Handle HWND nella finestra di output. Questo membro non deve essere NULL.

Windowed

Tipo: BOOL

Valore booleano che specifica se l'output è in modalità finestra. TRUE se l'output è in modalità finestra; in caso contrario, FALSE.

È consigliabile creare una catena di scambio finestra e consentire all'utente finale di modificare la catena di scambio a schermo intero tramite IDXGISwapChain::SetFullscreenState; ovvero, non impostare questo membro su FALSE per forzare che la catena di scambio sia a schermo intero. Tuttavia, se si crea la catena di scambio come schermo intero, fornire anche all'utente finale un elenco di modalità di visualizzazione supportate tramite il membro BufferDesc perché una catena di scambio creata con una modalità di visualizzazione non supportata potrebbe causare la visualizzazione nera e impedire all'utente finale di visualizzare nulla.

Per altre informazioni sulla scelta di versi finestra a schermo intero, vedere IDXGIFactory::CreateSwapChain.

SwapEffect

Tipo: DXGI_SWAP_EFFECT

Membro del tipo enumerato DXGI_SWAP_EFFECT che descrive le opzioni per la gestione del contenuto del buffer di presentazione dopo la presentazione di una superficie.

Flags

Tipo: UINT

Membro del tipo enumerato DXGI_SWAP_CHAIN_FLAG che descrive le opzioni per il comportamento della catena di scambio.

Commenti

Questa struttura viene usata dai metodi GetDesc e CreateSwapChain .

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

Se si crea una catena di scambio con un buffer, specificando DXGI_SWAP_EFFECT_SEQUENTIAL il contenuto del singolo buffer non viene scambiato con il buffer anteriore.

Per informazioni sulle prestazioni sullo scorrimento dei buffer della catena di scambio nell'applicazione a schermo intero, vedere Hint per le prestazioni dell'applicazione a schermo intero.

Requisiti

Intestazione	dxgi.h

Vedi anche

Strutture DXGI

IDXGIFactory::CreateSwapChain

IDXGISwapChain