IDXGISwapChain1::SetRotation メソッド (dxgi1_2.h)
スワップ チェーンのバック バッファーの回転を設定します。
構文
HRESULT SetRotation(
[in] DXGI_MODE_ROTATION Rotation
);
パラメーター
[in] Rotation
スワップ チェーンのバック バッファーの回転を設定する方法を指定する、 DXGI_MODE_ROTATION型の値。
戻り値
SetRotation は 次を返します。
- 回転が正常に設定された場合は、S_OKします。
- スワップ チェーンがビット ブロック転送 (ビットblt) モデルの場合にDXGI_ERROR_INVALID_CALLします。 SetRotation を正常に呼び出すには、スワップ チェーンがフリップ モデルである必要があります。
- DXGI_ERRORトピックで説明されているその他のエラー コード。
Windows 7 のプラットフォーム更新プログラム: Windows 7 用プラットフォーム更新プログラム がインストールされている Windows 7 または Windows Server 2008 R2 では、 SetRotation がDXGI_ERROR_INVALID_CALLで失敗します。 Windows 7 のプラットフォーム更新プログラムの詳細については、「Windows 7 用プラットフォーム更新プログラム」を参照してください。
解説
SetRotation を使用して回転できるのは、ウィンドウ モードで存在するフリップ モデル スワップ チェーンのバック バッファーのみです。
SetRotation は、全画面表示モードで表示するフリップ モデル スワップ チェーンのバック バッファーの回転ではサポートされていません。 このような場合、 SetRotation は失敗しませんが、スワップ チェーンにローテーション (DXGI_MODE_ROTATION_IDENTITY) を指定しないようにする必要があります。 それ以外の場合、 IDXGISwapChain1::P resent1 または IDXGISwapChain::P resent を呼び出してフレームを表示すると、プレゼンテーションは失敗します。
要件
| サポートされている最小のクライアント | Windows 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dxgi1_2.h |
| Library | Dxgi.lib |