DXGI_OUTPUT_DESC1構造体 (dxgi1_6.h)

カラー機能と接続の種類に関する追加情報など、アダプター (ビデオ カード) とデバイスの間の出力または物理的な接続について説明します。

構文

typedef struct DXGI_OUTPUT_DESC1 {
  WCHAR                 DeviceName[32];
  RECT                  DesktopCoordinates;
  BOOL                  AttachedToDesktop;
  DXGI_MODE_ROTATION    Rotation;
  HMONITOR              Monitor;
  UINT                  BitsPerColor;
  DXGI_COLOR_SPACE_TYPE ColorSpace;
  FLOAT                 RedPrimary[2];
  FLOAT                 GreenPrimary[2];
  FLOAT                 BluePrimary[2];
  FLOAT                 WhitePoint[2];
  FLOAT                 MinLuminance;
  FLOAT                 MaxLuminance;
  FLOAT                 MaxFullFrameLuminance;
} DXGI_OUTPUT_DESC1;

メンバーズ

DeviceName[32]

型: WCHAR[32]

出力デバイスの名前を含む文字列。

DesktopCoordinates

型: RECT

デスクトップ座標の出力の境界を含む RECT 構造体。 デスクトップ座標は、デスクトップの 1 インチあたりのドット数 (DPI) によって異なります。 DPI 対応 Win32 アプリの作成については、「高 DPI」を参照してください。

AttachedToDesktop

型: BOOL

出力がデスクトップにアタッチされている場合は True。それ以外の場合は false。

Rotation

型: DXGI_MODE_ROTATION

出力によってイメージがどのように回転されるかを説明する DXGI_MODE_ROTATION 列挙型のメンバー。

Monitor

型: HMONITOR

表示モニターを表す HMONITOR ハンドル。 詳細については、「HMONITOR とデバイス コンテキスト」を参照してください。

BitsPerColor

型: UINT

この出力に接続されているディスプレイのアクティブワイヤフォーマットのカラーチャンネルあたりのビット数。

ColorSpace

型: DXGI_COLOR_SPACE_TYPE

この出力に接続されているディスプレイの現在の高度な色機能。 具体的には、sRGB 色空間の外部で色と輝度の値を再現できるかどうか。 DXGI_COLOR_SPACE_RGB_FULL_G22_NONE_P709 の値は、表示が SDR/sRGB に制限されていることを示します。 DXGI_COLOR_SPACE_RGB_FULL_G2048_NONE_P2020 の値は、ディスプレイが高度なカラー機能をサポートしていることを示します。 DXGI_COLOR_SPACE_RGB_FULL_G10_NONE_P709 は現在、使用を表示する色空間ではありません。これは単なる中間スワップ チェーンの色空間です。

輝度と色の機能の詳細については、この構造体の追加メンバーを参照してください。

RedPrimary[2]

型: FLOAT[2]

この出力にアタッチされているディスプレイの赤のプライマリカラー (xy 座標)。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

GreenPrimary[2]

型: FLOAT[2]

この出力にアタッチされているディスプレイの緑色のプライマリ (xy 座標)。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

BluePrimary[2]

型: FLOAT[2]

この出力にアタッチされているディスプレイの青のプライマリカラー (xy 座標)。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

WhitePoint[2]

型: FLOAT[2]

この出力にアタッチされている表示の白い点 (xy 座標)。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

MinLuminance

型: FLOAT

この出力にアタッチされたディスプレイがレンダリング可能な最小輝度 (ニト単位)。 最適なレンダリングを行うには、コンテンツがこの最小値を超えないようにする必要があります。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

MaxLuminance

型: FLOAT

この出力にアタッチされたディスプレイがレンダリング可能な最大輝度 (ニト単位)。この値は、パネルの小さな領域に対してのみ有効である可能性があります。 最適なレンダリングを行うには、コンテンツがこの最小値を超えないようにする必要があります。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

MaxFullFrameLuminance

型: FLOAT

この出力にアタッチされたディスプレイがレンダリング可能な最大輝度 (ニト単位)。MaxLuminance とは異なり、この値はパネルの領域全体を塗りつぶす色に対して有効です。 最適なレンダリングを行うには、パネル全体でコンテンツがこの値を超えないようにする必要があります。 この値は通常、対応するディスプレイの EDID から取得されるか、オーバーライドから取得される場合があります。

備考

DXGI_OUTPUT_DESC1 構造体は、IDXGIOutput6::GetDesc1 メソッドによって初期化されます。

必要条件

要件	価値
ヘッダー	dxgi1_6.h

関連項目

DXGI 構造体 を する