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

Weitere Informationen

IDXGISwapChain2

SetMatrixTransform