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

Définit 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 SetMatrixTransform(
  const DXGI_MATRIX_3X2_F *pMatrix
);

Paramètres

pMatrix

Matrice de transformation à utiliser pour la mise à l’échelle et la traduction de la chaîne d’échange. Cette fonction ne peut être utilisée qu’avec les chaînes d’échange de composition créées par IDXGIFactory2 ::CreateSwapChainForComposition. Seuls les composants de mise à l’échelle et de traduction sont autorisés dans la matrice.

Valeur retournée

SetMatrixTransform retourne :

• S_OK s’il récupère correctement la matrice de transformation.
• E_INVALIDARG si le paramètre pMatrix est incorrect, par exemple, pMatrix a la valeur NULL ou la matrice représentée par DXGI_MATRIX_3X2_F inclut des composants autres que la mise à l’échelle et la traduction.
• 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

GetMatrixTransform

IDXGISwapChain2