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

関連項目

IDXGISwapChain1