Méthode IDXGISwapChain2 ::GetMatrixTransform (dxgi1_3.h)

Obtient la matrice de transformation qui sera appliquée à une chaîne d’échange de composition au présent suivant.

À compter de Windows 8.1, les applications du Windows Store peuvent placer des visuels de chaîne d’échange DirectX dans des pages XAML à l’aide de l’élément SwapChainPanel, qui peut être placé et dimensionné arbitrairement. Cela expose les visuels de la chaîne d’échange DirectX aux scénarios de mise à l’échelle tactile et de traduction à l’aide de l’interface utilisateur tactile. Les méthodes GetMatrixTransform et SetMatrixTransform sont utilisées pour synchroniser la mise à l’échelle de la chaîne d’échange DirectX avec l’élément SwapChainPanel associé. Seuls les éléments de mise à l’échelle/traduction simples dans la matrice sont autorisés : l’appel échoue si la matrice contient des éléments d’asymétrie/rotation.

Syntaxe

HRESULT GetMatrixTransform(
  DXGI_MATRIX_3X2_F *pMatrix
);

Paramètres

pMatrix

[out]

Matrice de transformation actuellement utilisée pour la mise à l’échelle et la traduction de la chaîne d’échange.

Valeur retournée

GetMatrixTransform retourne :

• S_OK s’il récupère correctement la matrice de transformation.
• DXGI_ERROR_INVALID_CALL si la méthode est appelée sur une chaîne d’échange qui n’a pas été créée avec CreateSwapChainForComposition.
• Éventuellement d’autres codes d’erreur décrits dans la rubrique DXGI_ERROR .

Configuration requise

Voir aussi

IDXGISwapChain2

SetMatrixTransform