Compartir a través de

Método IDXGISwapChain2::SetMatrixTransform (dxgi1_3.h)

  • Artículo

Establece la matriz de transformación que se aplicará a una cadena de intercambio de composición en el siguiente presente.

A partir de Windows 8.1, las aplicaciones de la Tienda Windows pueden colocar objetos visuales de cadena de intercambio de DirectX en páginas XAML mediante el elemento SwapChainPanel, que se puede colocar y ajustar de forma arbitraria. Esto expone los objetos visuales de la cadena de intercambio de DirectX a escenarios de escalado y traducción táctiles mediante la interfaz de usuario táctil. Los métodos GetMatrixTransform y SetMatrixTransform se usan para sincronizar el escalado de la cadena de intercambio de DirectX con su elemento SwapChainPanel asociado. Solo se permiten elementos de escala y traducción simples en la matriz: se producirá un error en la llamada si la matriz contiene elementos de asimetría o rotación.

Sintaxis

HRESULT SetMatrixTransform(
  const DXGI_MATRIX_3X2_F *pMatrix
);

Parámetros

pMatrix

Matriz de transformación que se va a usar para el escalado y la traducción de cadenas de intercambio. Esta función solo se puede usar con cadenas de intercambio de composición creadas por IDXGIFactory2::CreateSwapChainForComposition. Solo se permiten componentes de escala y traducción en la matriz.

Valor devuelto

SetMatrixTransform devuelve:

  • S_OK si recupera correctamente la matriz de transformación.
  • E_INVALIDARG si el parámetro pMatrix es incorrecto, por ejemplo, pMatrix es NULL o la matriz representada por DXGI_MATRIX_3X2_F incluye componentes distintos de la escala y la traducción.
  • DXGI_ERROR_INVALID_CALL si se llama al método en una cadena de intercambio que no se creó con CreateSwapChainForComposition.
  • Posiblemente otros códigos de error que se describen en el tema DXGI_ERROR .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dxgi1_3.h
Library Dxgi.lib

Consulte también

GetMatrixTransform

IDXGISwapChain2