estructura DXGI_SWAP_CHAIN_DESC1 (dxgi1_2.h)

Describe una cadena de intercambio.

Sintaxis

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;

Miembros

Width

Valor que describe el ancho de resolución. Si especifica el ancho como cero al llamar al método IDXGIFactory2::CreateSwapChainForHwnd para crear una cadena de intercambio, el tiempo de ejecución obtiene el ancho de la ventana de salida y asigna este valor de ancho a la descripción de la cadena de intercambio. Posteriormente, puede llamar al método IDXGISwapChain1::GetDesc1 para recuperar el valor de ancho asignado. No se puede especificar el ancho como cero al llamar al método IDXGIFactory2::CreateSwapChainForComposition .

Height

Valor que describe el alto de resolución. Si especifica el alto como cero al llamar al método IDXGIFactory2::CreateSwapChainForHwnd para crear una cadena de intercambio, el tiempo de ejecución obtiene el alto de la ventana de salida y asigna este valor de alto a la descripción de la cadena de intercambio. Posteriormente, puede llamar al método IDXGISwapChain1::GetDesc1 para recuperar el valor de alto asignado. No se puede especificar el alto como cero al llamar al método IDXGIFactory2::CreateSwapChainForComposition .

Format

Estructura DXGI_FORMAT que describe el formato de presentación.

Stereo

Especifica si el modo de visualización de pantalla completa o el búfer back de la cadena de intercambio es estéreo. TRUE si estéreo; de lo contrario, FALSE. Si especifica estéreo, también debe especificar una cadena de intercambio de modelo invertido (es decir, una cadena de intercambio que tenga el valor DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL establecido en el miembro SwapEffect ).

SampleDesc

Estructura DXGI_SAMPLE_DESC que describe los parámetros de muestreo múltiple. Este miembro solo es válido con cadenas de intercambio de modelos de transferencia de bloques de bits (bitblt).

BufferUsage

Valor de tipo DXGI_USAGE que describe las opciones de uso de superficie y acceso a la 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

Valor que describe el número de búferes de la cadena de intercambio. Al crear una cadena de intercambio de pantalla completa, normalmente se incluye el búfer frontal en este valor.

Scaling

Valor de tipo DXGI_SCALING que identifica el comportamiento de cambio de tamaño si el tamaño del búfer de reserva no es igual a la salida de destino.

SwapEffect

Valor de tipo DXGI_SWAP_EFFECT que describe el modelo de presentación que usa la cadena de intercambio y las opciones para controlar el contenido del búfer de presentación después de presentar una superficie. Debe especificar el valor de DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL al llamar al método IDXGIFactory2::CreateSwapChainForComposition porque este método solo admite el modelo de presentación invertida.

AlphaMode

Valor de tipo DXGI_ALPHA_MODE que identifica el comportamiento de transparencia del búfer back de la cadena de intercambio.

Flags

Combinación de valores con tipo DXGI_SWAP_CHAIN_FLAG que se combinan mediante una operación OR bit a bit. El valor resultante especifica las opciones para el comportamiento de la cadena de intercambio.

Comentarios

Esta estructura la usan los métodos CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle y GetDesc1 .

Nota No se puede convertir un DXGI_SWAP_CHAIN_DESC1 a un DXGI_SWAP_CHAIN_DESC y viceversa. Una aplicación debe usar explícitamente el método IDXGISwapChain1::GetDesc1 para recuperar la versión más reciente de la estructura de descripción de la cadena de intercambio.

 

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

Para una cadena de intercambio de modelo invertido (es decir, una cadena de intercambio que tenga el valor DXGI_SWAP_EFFECT_FLIP_DISCARD o DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL establecido en el miembro SwapEffect ), debe establecer el miembro Formaten DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM o DXGI_FORMAT_R10G10B10A10_UNORM; Debe establecer el miembro Count de la estructura DXGI_SAMPLE_DESC que el miembro SampleDesc especifica en uno y el miembro Quality de DXGI_SAMPLE_DESC en cero porque no se admiten varios suavizados de contorno de muestra (MSAA); Debe establecer el miembro BufferCount en de dos a dieciséis. Para obtener más información sobre la cadena de intercambio de modelo invertida, consulta DXGI Flip Model.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado	dxgi1_2.h

Consulte también

Estructuras DXGI

IDXGISwapChain1::GetDesc1