DISPLAYCONFIG_PATH_TARGET_INFO構造体 (wingdi.h)
DISPLAYCONFIG_PATH_TARGET_INFO構造体には、1 つのパスのターゲット情報が含まれています。
構文
typedef struct DISPLAYCONFIG_PATH_TARGET_INFO {
LUID adapterId;
UINT32 id;
union {
UINT32 modeInfoIdx;
struct {
UINT32 desktopModeInfoIdx : 16;
UINT32 targetModeInfoIdx : 16;
} DUMMYSTRUCTNAME;
} DUMMYUNIONNAME;
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY outputTechnology;
DISPLAYCONFIG_ROTATION rotation;
DISPLAYCONFIG_SCALING scaling;
DISPLAYCONFIG_RATIONAL refreshRate;
DISPLAYCONFIG_SCANLINE_ORDERING scanLineOrdering;
BOOL targetAvailable;
UINT32 statusFlags;
} DISPLAYCONFIG_PATH_TARGET_INFO;
メンバー
adapterId
パスがオンになっているアダプターの識別子。
id
このパスが関連付ける指定したアダプターのターゲット識別子。
DUMMYUNIONNAME
DUMMYUNIONNAME.modeInfoIdx
DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODEが設定されていない場合にのみ、このパスのターゲット モード情報を含むモード情報テーブルへの有効なインデックス。 ターゲット モード情報が使用できない場合、 modeInfoIdx の値はDISPLAYCONFIG_PATH_MODE_IDX_INVALID。
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx
DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODEが設定されている場合にのみ、このパスのデスクトップ モード情報を含む、DISPLAYCONFIG_DESKTOP_IMAGE_INFO エントリの mode 配列への有効なインデックス。 モード配列にこのエントリがない場合、 desktopModeInfoIdx の値はDISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID。 Windows 10 以降でサポートされています。
DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx
DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODEが設定されている場合にのみ、このパスのターゲット モード情報を含む、DISPLAYCONFIG_TARGET_MODE エントリの mode 配列への有効なインデックス。 モード配列にこのエントリがない場合、 targetModeInfoIdx の値はDISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID。 Windows 10 以降でサポートされています。
outputTechnology
ターゲットのコネクタの種類。 使用可能な値の一覧については、 DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY 列挙型に関するページを参照してください。
rotation
ターゲットの回転を示す 値。 使用可能な値の一覧については、 DISPLAYCONFIG_ROTATION 列挙型に関するページを参照してください。
scaling
ソース イメージをターゲットにスケーリングする方法を示す 値。 使用可能な値の一覧については、 DISPLAYCONFIG_SCALING 列挙型に関するページを参照してください。 スケーリングの詳細については、「 デスクトップ イメージのスケーリング」を参照してください。
refreshRate
ターゲットの更新速度を指定する DISPLAYCONFIG_RATIONAL 構造体。 呼び出し元がターゲット モード情報を指定した場合、オペレーティング システムは代わりに、DISPLAYCONFIG_VIDEO_SIGNAL_INFO構造体の vSyncFreq メンバーに格納されている更新レートを使用します。 この場合、呼び出し元は、DISPLAYCONFIG_TARGET_MODE構造体の targetVideoSignalInfo メンバーにこの値を指定します。 分子と分母の両方を 0 に設定した更新レートは、呼び出し元が更新レートを指定せず、オペレーティング システムで使用可能な最適な更新レートを使用する必要があることを示します。 この場合、 SetDisplayConfig 関数の呼び出しでは、呼び出し元は scanLineOrdering メンバーを DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED値に設定する必要があります。それ以外の場合、 SetDisplayConfig は 失敗します。
scanLineOrdering
ターゲットの出力のスキャン行の順序を示す 値。 使用可能な値の一覧については、 DISPLAYCONFIG_SCANLINE_ORDERING 列挙型に関するページを参照してください。 呼び出し元がターゲット モード情報を指定した場合、オペレーティング システムは、代わりに、DISPLAYCONFIG_VIDEO_SIGNAL_INFO構造体の scanLineOrdering メンバーに格納されているスキャン行の順序を使用します。 この場合、呼び出し元は、DISPLAYCONFIG_TARGET_MODE構造体の targetVideoSignalInfo メンバーにこの値を指定します。
targetAvailable
ターゲットが使用可能かどうかを示すブール値。 TRUE は 、ターゲットが使用可能であることを示します。
モニターを削除すると、ディスプレイ トポロジの非同期性が変わるため、モニターが削除された場合でも、パスはアクティブとしてマークされる可能性があります。 このような場合、アクティブ パスの targetAvailable は FALSE になる可能性があります。 これは通常、オペレーティング システムがモニターの削除に対してアクションを実行した後に変化する一時的な状況です。
statusFlags
ターゲットの状態を示すフラグ値のビットごとの OR。 サポートされている値を次に示します。
注釈
DISPLAYCONFIG_PATH_TARGET_INFO構造体は、DISPLAYCONFIG_PATH_INFO構造体の targetInfo メンバーで指定されます。
ターゲットは、ディスプレイ アダプターで使用可能なビデオ出力の数に対応します。 ただし、この数は、ディスプレイ アダプター上の物理コネクタの数と同じではありません。 各コネクタは、古いコネクタ テクノロジとの下位互換性を含む多数のターゲットを公開します。 たとえば、FQD コネクタは、VGA ターゲットと同様に、FQD ターゲットを公開します。 2006 年に導入された DisplayPort コネクタは、DisplayPort、HDMI、BIOS、レガシ テレビ、VGA ターゲットを公開します。
statusFlags メンバーは、QueryDisplayConfig 関数を呼び出すときに設定されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 クライアントで使用できます。 |
| Header | wingdi.h (Windows.h を含む) |
こちらもご覧ください
DISPLAYCONFIG_SCANLINE_ORDERING
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY