IDXGISwapChain2::SetMatrixTransform-Methode (dxgi1_3.h)
Legt die Transformationsmatrix fest, die bei der nächsten Gegenwart auf eine Kompositions-Swapchain angewendet wird.
Ab Windows 8.1 können Windows Store-Apps DirectX-Swapchainvisuals mithilfe des SwapChainPanel-Elements auf XAML-Seiten platzieren, das beliebig platziert und angepasst werden kann. Dadurch werden die DirectX-Swapchainvisuals für Touchskalierungs- und Übersetzungsszenarien über die Touch-Benutzeroberfläche verfügbar gemacht. Die Methoden GetMatrixTransform und SetMatrixTransform werden verwendet, um die Skalierung der DirectX-Swapchain mit dem zugeordneten SwapChainPanel-Element zu synchronisieren. Nur einfache Skalierungs-/Übersetzungselemente in der Matrix sind zulässig. Der Aufruf schlägt fehl, wenn die Matrix Skew-/Drehungselemente enthält.
Syntax
HRESULT SetMatrixTransform(
const DXGI_MATRIX_3X2_F *pMatrix
);
Parameter
pMatrix
Die Transformationsmatrix, die für die Swapchainskalierung und -übersetzung verwendet werden soll. Diese Funktion kann nur mit KompositionsswapChainForComposition verwendet werden, die von IDXGIFactory2::CreateSwapChainForComposition erstellt wurden. In der Matrix sind nur Skalierungs- und Übersetzungskomponenten zulässig.
Rückgabewert
SetMatrixTransform gibt Folgendes zurück:
- S_OK, wenn die Transformationsmatrix erfolgreich abgerufen wird.
- E_INVALIDARG, wenn der pMatrix-Parameter falsch ist, z. B. ist pMatrix NULL oder die Matrix, die durch DXGI_MATRIX_3X2_F dargestellt wird, enthält andere Komponenten als Skalierung und Übersetzung.
- DXGI_ERROR_INVALID_CALL, wenn die Methode für eine Swapchain aufgerufen wird, die nicht mit CreateSwapChainForComposition erstellt wurde.
- Möglicherweise weitere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dxgi1_3.h |
| Bibliothek | Dxgi.lib |