共用方式為


IDXGISwapChain2::SetMatrixTransform 方法 (dxgi1_3.h)

設定將在下一個存在時套用至組合交換鏈結的轉換矩陣。

從 Windows 8.1 開始,Windows 市集應用程式可以使用 SwapChainPanel 元素,將 DirectX 交換鏈結視覺效果放在 XAML 頁面中,您可以任意放置及調整大小。 這會使用觸控 UI 向觸控縮放和轉譯案例公開 DirectX 交換鏈結視覺效果。 GetMatrixTransformSetMatrixTransform 方法可用來同步處理 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
程式庫 Dxgi.lib

另請參閱

GetMatrixTransform

IDXGISwapChain2