Freigeben über


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