次の方法で共有


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 は 、ターゲットが使用可能であることを示します。

モニターを削除すると、ディスプレイ トポロジの非同期性が変わるため、モニターが削除された場合でも、パスはアクティブとしてマークされる可能性があります。 このような場合、アクティブ パスの targetAvailableFALSE になる可能性があります。 これは通常、オペレーティング システムがモニターの削除に対してアクションを実行した後に変化する一時的な状況です。

statusFlags

ターゲットの状態を示すフラグ値のビットごとの OR。 サポートされている値を次に示します。

意味
DISPLAYCONFIG_TARGET_IN_USE
0x00000001
ターゲットはアクティブ パスで使用されています。
DISPLAYCONFIG_TARGET_FORCIBLE
0x00000002
モニターが検出されない場合でも、このターゲットで出力を強制できます。
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT
0x00000004
現在、出力はブート永続的な方法で強制されています。
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH
0x00000008
現在、出力はパス永続的な方法で強制されています。
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM
0x00000010
現在、出力は持続しない方法で強制されています。
DISPLAYCONFIG_TARGET_IS_HMD
0x00000020
出力はヘッドマウント ディスプレイ (HMD) です。 このようなパスは、QDC_INCLUDE_HMD フラグを使用して QueryDisplayConfig からしか返されません。

Windows 10 Creators Update (バージョン 1703) 以降でサポートされています。

注釈

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_PATH_INFO

DISPLAYCONFIG_RATIONAL

DISPLAYCONFIG_ROTATION

DISPLAYCONFIG_SCALING

DISPLAYCONFIG_SCANLINE_ORDERING

DISPLAYCONFIG_TARGET_MODE

DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY

DISPLAYCONFIG_VIDEO_SIGNAL_INFO

QueryDisplayConfig