estructura DXGI_SWAP_CHAIN_DESC (dxgi.h)

Describe una cadena de intercambio.

Sintaxis

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;

Miembros

BufferDesc

Tipo: DXGI_MODE_DESC

Estructura DXGI_MODE_DESC que describe el modo de presentación del búfer de retroceso.

SampleDesc

Tipo: DXGI_SAMPLE_DESC

Estructura DXGI_SAMPLE_DESC que describe los parámetros de muestreo múltiple.

BufferUsage

Tipo: DXGI_USAGE

Miembro del DXGI_USAGE tipo enumerado que describe las opciones de uso de superficie y acceso de CPU para el búfer de reserva. El búfer de reserva se puede usar para la entrada del sombreador o la salida de destino de representación.

BufferCount

Tipo: UINT

Valor que describe el número de búferes de la cadena de intercambio. Al llamar a IDXGIFactory::CreateSwapChain para crear una cadena de intercambio de pantalla completa, normalmente se incluye el búfer frontal en este valor. Para obtener más información sobre los búferes de cadena de intercambio, vea Comentarios.

OutputWindow

Tipo: HWND

Un controlador HWND en la ventana de salida. Este miembro no debe ser NULL.

Windowed

Tipo: BOOL

Valor booleano que especifica si la salida está en modo de ventana. TRUE si la salida está en modo de ventana; de lo contrario, FALSE.

Se recomienda crear una cadena de intercambio con ventanas y permitir que el usuario final cambie la cadena de intercambio a pantalla completa a través de IDXGISwapChain::SetFullscreenState; es decir, no establezca este miembro en FALSE para forzar que la cadena de intercambio sea de pantalla completa. Sin embargo, si crea la cadena de intercambio como pantalla completa, también proporciona al usuario final una lista de modos de visualización admitidos a través del miembro BufferDesc porque una cadena de intercambio que se crea con un modo de presentación no compatible podría hacer que la pantalla se vuelva negra y evitar que el usuario final vea nada.

Para obtener más información sobre cómo elegir versículos con ventanas en pantalla completa, vea IDXGIFactory::CreateSwapChain.

SwapEffect

Tipo: DXGI_SWAP_EFFECT

Miembro del DXGI_SWAP_EFFECT tipo enumerado que describe las opciones para controlar el contenido del búfer de presentación después de presentar una superficie.

Flags

Tipo: UINT

Miembro del DXGI_SWAP_CHAIN_FLAG tipo enumerado que describe las opciones para el comportamiento de la cadena de intercambio.

Comentarios

Los métodos GetDesc y CreateSwapChain usan esta estructura.

En modo de pantalla completa, hay un búfer frontal dedicado; en modo de ventana, el escritorio es el búfer frontal.

Si crea una cadena de intercambio con un búfer, especificar DXGI_SWAP_EFFECT_SEQUENTIAL no hace que el contenido del único búfer se intercambie con el búfer frontal.

Para obtener información sobre el rendimiento sobre el volteo de búferes de cadena de intercambio en una aplicación de pantalla completa, consulte Sugerencias de rendimiento de aplicaciones de pantalla completa.

Requisitos

Consulte también

Estructuras DXGI

IDXGIFactory::CreateSwapChain

IDXGISwapChain