通过

IDXGISwapChain2：：SetMatrixTransform 方法 (dxgi1_3.h)

  • 项目

设置将在下一个呈现时应用于组合交换链的转换矩阵。

从Windows 8.1开始，Windows 应用商店应用可以使用 SwapChainPanel 元素将 DirectX 交换链视觉对象放置在 XAML 页面中，该元素可以任意放置和调整大小。 这将使用触摸 UI 向触摸缩放和转换方案公开 DirectX 交换链视觉对象。 GetMatrixTransform 和 SetMatrixTransform 方法用于将 DirectX 交换链的缩放与其关联的 SwapChainPanel 元素同步。 仅允许矩阵中的简单缩放/平移元素 - 如果矩阵包含倾斜/旋转元素，调用将失败。

语法

HRESULT SetMatrixTransform(
  const DXGI_MATRIX_3X2_F *pMatrix
);

参数

pMatrix

用于交换链缩放和转换的转换矩阵。 此函数只能与 IDXGIFactory2：：CreateSwapChainForComposition 创建的合成交换链一起使用。 矩阵中仅允许使用缩放和平移组件。

返回值

SetMatrixTransform 返回：

  • 如果成功检索转换矩阵，则S_OK。
  • E_INVALIDARG如果 pMatrix 参数不正确，例如， pMatrix 为 NULL，或者 DXGI_MATRIX_3X2_F 表示的矩阵包括除缩放和平移以外的组件。
  • DXGI_ERROR_INVALID_CALL是否在不是使用 CreateSwapChainForComposition 创建的交换链上调用方法。
  • 可能是 DXGI_ERROR 主题中描述的其他错误代码。

要求

要求 值
最低受支持的客户端 Windows 8.1 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dxgi1_3.h
Library Dxgi.lib

另请参阅

GetMatrixTransform

IDXGISwapChain2