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
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8.1 [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows Server 2012 R2 [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | dxgi1_3.h |
Bibliothèque | Dxgi.lib |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour