DISPLAYCONFIG_PATH_TARGET_INFO結構 (wingdi.h)

發行項
03/13/2024

DISPLAYCONFIG_PATH_TARGET_INFO 結構包含單一路徑的目標資訊。

語法

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 專案的模式陣列的有效索引。如果模式陣列中沒有這個專案， 則 desktopModeInfoIdx 的值會DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID。從Windows 10 開始支援。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

只有在設定DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE時，才會包含此路徑之目標模式資訊的 DISPLAYCONFIG_TARGET_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 成員中指定此值。將微調器和分母設定為零的重新整理速率表示呼叫端未指定重新整理速率，而且操作系統應該使用最佳的重新整理速率。在此情況下，在對 SetDisplayConfig 函式的呼叫中，呼叫端必須將 scanLineOrdering 成員設定為DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED值;否則， SetDisplayConfig 會失敗。

scanLineOrdering

值，指定目標上輸出的掃描行順序。如需可能值的清單，請參閱 DISPLAYCONFIG_SCANLINE_ORDERING 列舉類型。如果呼叫端指定目標模式資訊，操作系統會改用儲存在DISPLAYCONFIG_VIDEO_SIGNAL_INFO結構的 scanLineOrdering 成員中的掃描行順序。在此情況下，呼叫端會在 DISPLAYCONFIG_TARGET_MODE 結構的 targetVideoSignalInfo 成員中指定此值。

targetAvailable

布爾值，指定目標是否可用。 TRUE 表示目標可供使用。

由於移除監視器時顯示拓撲的異步本質會變更，因此即使已移除監視器，仍可能會將路徑標示為作用中。在這種情況下，active 路徑 的 targetAvailable 可能是 FALSE 。這通常是在操作系統在移除監視器時採取動作之後變更的暫時性情況。

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 成員中指定。

目標會對應到顯示器適配卡上可能的視訊輸出數目。不過，這個數位不等於顯示器適配卡上的實體連接器數目。每個連接器都會公開許多目標，其中包括與舊版連接器技術的回溯相容性。例如，DVI 連接器會公開 DVI 目標，以及 VGA 目標。 2006 年引進的 DisplayPort 連接器會公開 DisplayPort、HDMI、DVI、舊版電視及 VGA 目標。

當您呼叫 QueryDisplayConfig 函式時，會設定 statusFlags 成員。