Método IDXGISwapChain2::SetMatrixTransform (dxgi1_3.h)
Define a matriz de transformação que será aplicada a uma cadeia de troca de composição no próximo presente.
Começando com Windows 8.1, os aplicativos da Windows Store são capazes de colocar visuais de cadeia de troca DirectX em páginas XAML usando o elemento SwapChainPanel, que pode ser colocado e dimensionado arbitrariamente. Isso expõe os visuais da cadeia de troca do DirectX para cenários de dimensionamento e tradução por toque usando a interface do usuário de toque. Os métodos GetMatrixTransform e SetMatrixTransform são usados para sincronizar o dimensionamento da cadeia de troca DirectX com seu elemento SwapChainPanel associado. Somente elementos simples de escala/tradução na matriz são permitidos – a chamada falhará se a matriz contiver elementos de distorção/rotação.
Sintaxe
HRESULT SetMatrixTransform(
const DXGI_MATRIX_3X2_F *pMatrix
);
Parâmetros
pMatrix
A matriz de transformação a ser usada para o dimensionamento e a tradução da cadeia de troca. Essa função só pode ser usada com cadeias de troca de composição criadas por IDXGIFactory2::CreateSwapChainForComposition. Somente componentes de escala e tradução são permitidos na matriz.
Retornar valor
SetMatrixTransform retorna:
- S_OK se recuperar com êxito a matriz de transformação.
- E_INVALIDARG se o parâmetro pMatrix estiver incorreto, por exemplo, pMatrix for NULL ou a matriz representada por DXGI_MATRIX_3X2_F inclui componentes diferentes de escala e tradução.
- DXGI_ERROR_INVALID_CALL se o método for chamado em uma cadeia de troca que não foi criada com CreateSwapChainForComposition.
- Possivelmente outros códigos de erro descritos no tópico DXGI_ERROR .
Requisitos
| Cliente mínimo com suporte | Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi1_3.h |
| Biblioteca | Dxgi.lib |