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 |