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

  • Artigo

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

Confira também

GetMatrixTransform

IDXGISwapChain2