Share via

IDXGISwapChain2::SetMatrixTransform-Methode (dxgi1_3.h)

  • Artikel

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

Weitere Informationen

GetMatrixTransform

IDXGISwapChain2