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.
A partir do Windows 8.1, os aplicativos da Windows Store podem colocar visuais da 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 por toque e tradução 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 é 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
| Requisito | Valor |
|---|---|
| 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 |