Método IDXGISwapChain::ResizeTarget (dxgi.h)

Cambia el tamaño del destino de salida.

Sintaxis

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

Parámetros

[in] pNewTargetParameters

Tipo: const DXGI_MODE_DESC*

Puntero a una estructura DXGI_MODE_DESC que describe el modo , que especifica el nuevo ancho, alto, formato y frecuencia de actualización del destino. Si el formato es DXGI_FORMAT_UNKNOWN, ResizeTarget usa el formato existente. Solo se recomienda usar DXGI_FORMAT_UNKNOWN cuando la cadena de intercambio esté en modo de pantalla completa, ya que este método no es seguro para subprocesos.

Valor devuelto

Tipo: HRESULT

Devuelve un código que indica éxito o error. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS se devuelve si se produce una transición en modo de pantalla completa o ventana cuando se llama a esta API. Consulte DXGI_ERROR para obtener códigos de error DXGI adicionales.

Comentarios

ResizeTarget cambia el tamaño de la ventana de destino cuando la cadena de intercambio está en modo de ventana y cambia el modo de presentación en la salida de destino cuando la cadena de intercambio está en modo de pantalla completa. Por lo tanto, las aplicaciones pueden llamar a ResizeTarget para cambiar el tamaño de la ventana de destino (en lugar de microsoft Win32API como SetWindowPos) sin tener conocimiento del modo de presentación de la cadena de intercambio.

Si una aplicación de la Tienda Windows llama a ResizeTarget, se produce un error con DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

No puede llamar a ResizeTarget en una cadena de intercambio que creó con IDXGIFactory2::CreateSwapChainForComposition.

Las aplicaciones deben seguir llamando a IDXGISwapChain::ResizeBuffers después de llamar a ResizeTarget porque solo ResizeBuffers puede cambiar los búferes de reserva. Sin embargo, si esas aplicaciones han implementado el procesamiento de cambio de tamaño de ventana para llamar a ResizeBuffers, no necesitan llamar explícitamente a ResizeBuffers después de llamar a ResizeTarget porque el procesamiento de cambio de tamaño de ventana logrará lo que requiere la aplicación.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	dxgi.h
Library	DXGI.lib

Consulte también

IDXGISwapChain