GetMatrixTransform

IDXGISwapChain2::GetMatrixTransform method

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(
  [out] 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

Minimum supported client

Windows 8.1 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 R2 [desktop apps | Windows Store apps]

Header

Dxgi1_3.h

Library

Dxgi.lib

See also

DirectX foreground swap chains sample
IDXGISwapChain2
SetMatrixTransform

 

 

Show:
© 2016 Microsoft