Método IDXGISwapChain2::SetMatrixTransform (dxgi1_3.h)
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 |