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します。
- pMatrix パラメーターが正しくない場合にE_INVALIDARGします。たとえば、pMatrix が NULL であるか、DXGI_MATRIX_3X2_Fで表される行列にスケールと平行移動以外のコンポーネントが含まれます。
- CreateSwapChainForComposition で作成されていないスワップ チェーンで メソッドが呼び出された場合にDXGI_ERROR_INVALID_CALLします。
- DXGI_ERRORトピックで説明されているその他のエラー コード。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dxgi1_3.h |
| Library | Dxgi.lib |