IDXGISwapChain2::GetMatrixTransform-Methode (dxgi1_3.h)
Ruft die Transformationsmatrix ab, 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 GetMatrixTransform(
DXGI_MATRIX_3X2_F *pMatrix
);
Parameter
pMatrix
[out]
Die Transformationsmatrix, die derzeit für die Swapchainskalierung und -übersetzung verwendet wird.
Rückgabewert
GetMatrixTransform gibt Folgendes zurück:
- S_OK, wenn die Transformationsmatrix erfolgreich abgerufen wird.
- 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 |