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 主題中 可能描述的其他錯誤碼。

規格需求

另請參閱

GetMatrixTransform

IDXGISwapChain2