IDXGISwapChain2::GetMatrixTransform method (dxgi1_3.h)

Gets the transform matrix that will be applied to a composition swap chain upon the next present.

Starting with Windows 8.1, Windows Store apps are able to place DirectX swap chain visuals in XAML pages using the SwapChainPanel element, which can be placed and sized arbitrarily. This exposes the DirectX swap chain visuals to touch scaling and translation scenarios using touch UI. The GetMatrixTransform and SetMatrixTransform methods are used to synchronize scaling of the DirectX swap chain with its associated SwapChainPanel element. Only simple scale/translation elements in the matrix are allowed – the call will fail if the matrix contains skew/rotation elements.

Syntax

HRESULT GetMatrixTransform(
  DXGI_MATRIX_3X2_F *pMatrix
);

Parameters

pMatrix

[out]

The transform matrix currently used for swap chain scaling and translation.

Return value

GetMatrixTransform returns:

• S_OK if it successfully retrieves the transform matrix.
• DXGI_ERROR_INVALID_CALL if the method is called on a swap chain that was not created with CreateSwapChainForComposition.
• Possibly other error codes that are described in the DXGI_ERROR topic.

Requirements

See also

IDXGISwapChain2

SetMatrixTransform