DISPLAYCONFIG_PATH_TARGET_INFO 구조체(wingdi.h)

아티클
08/27/2023

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 멤버에서 이 값을 지정합니다. 숫자와 분모가 모두 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_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 크리에이터스 업데이트(버전 1703)부터 지원됩니다.

설명

DISPLAYCONFIG_PATH_TARGET_INFO 구조체는 DISPLAYCONFIG_PATH_INFO 구조체의 targetInfo 멤버에 지정됩니다.

대상은 디스플레이 어댑터에서 가능한 비디오 출력 수에 해당합니다. 그러나 이 숫자는 디스플레이 어댑터의 실제 커넥터 수와 동일하지 않습니다. 각 커넥터는 이전 커넥터 기술과의 이전 버전과의 호환성을 포함하는 여러 대상을 노출합니다. 예를 들어 DVI 커넥터는 DVI 대상과 VGA 대상을 노출합니다. 2006년에 도입된 DisplayPort 커넥터는 DisplayPort, HDMI, DVI, 레거시 TV 및 VGA 대상을 노출합니다.

statusFlags 멤버는 QueryDisplayConfig 함수를 호출할 때 설정됩니다.