estrutura DISPLAYCONFIG_PATH_TARGET_INFO (wingdi.h)

Artigo
03/13/2024

A estrutura DISPLAYCONFIG_PATH_TARGET_INFO contém informações de destino para um único caminho.

Sintaxe

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;

Membros

adapterId

O identificador do adaptador no qual o caminho está.

id

O identificador de destino no adaptador especificado ao qual esse caminho está relacionado.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

Um índice válido na tabela de informações de modo que contém as informações do modo de destino para esse caminho somente quando DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE não está definido. Se as informações do modo de destino não estiverem disponíveis, o valor de modeInfoIdx será DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

Um índice válido na matriz de modo da entrada DISPLAYCONFIG_DESKTOP_IMAGE_INFO que contém as informações do modo de área de trabalho para esse caminho somente quando DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE está definido. Se não houver nenhuma entrada para isso na matriz de modo, o valor de desktopModeInfoIdx será DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Com suporte a partir de Windows 10.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

Um índice válido na matriz de modo da entrada DISPLAYCONFIG_TARGET_MODE que contém as informações do modo de destino para esse caminho somente quando DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE está definido. Se não houver nenhuma entrada para isso na matriz de modo, o valor de targetModeInfoIdx será DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Com suporte a partir de Windows 10.

outputTechnology

O tipo de conector do destino. Para obter uma lista de valores possíveis, consulte o DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY tipo enumerado.

rotation

Um valor que especifica a rotação do destino. Para obter uma lista de valores possíveis, consulte o DISPLAYCONFIG_ROTATION tipo enumerado.

scaling

Um valor que especifica como a imagem de origem é dimensionada para o destino. Para obter uma lista de valores possíveis, consulte o DISPLAYCONFIG_SCALING tipo enumerado. Para obter mais informações sobre o dimensionamento, consulte Dimensionando a imagem da área de trabalho.

refreshRate

Uma estrutura DISPLAYCONFIG_RATIONAL que especifica a taxa de atualização do destino. Se o chamador especificar informações do modo de destino, o sistema operacional usará a taxa de atualização armazenada no membro vSyncFreq da estrutura DISPLAYCONFIG_VIDEO_SIGNAL_INFO . Nesse caso, o chamador especifica esse valor no membro targetVideoSignalInfo da estrutura DISPLAYCONFIG_TARGET_MODE . Uma taxa de atualização com o numerador e o denominador definidos como zero indica que o chamador não especifica uma taxa de atualização e o sistema operacional deve usar a taxa de atualização mais ideal disponível. Nesse caso, em uma chamada para a função SetDisplayConfig , o chamador deve definir o membro scanLineOrdering como o valor DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED; caso contrário, SetDisplayConfig falhará.

scanLineOrdering

Um valor que especifica a ordenação de linha de verificação da saída no destino. Para obter uma lista de valores possíveis, consulte o DISPLAYCONFIG_SCANLINE_ORDERING tipo enumerado. Se o chamador especificar informações do modo de destino, o sistema operacional usará a ordenação de linha de verificação armazenada no membro scanLineOrdering da estrutura DISPLAYCONFIG_VIDEO_SIGNAL_INFO . Nesse caso, o chamador especifica esse valor no membro targetVideoSignalInfo da estrutura DISPLAYCONFIG_TARGET_MODE .

targetAvailable

Um valor booliano que especifica se o destino está disponível. TRUE indica que o destino está disponível.

Como a natureza assíncrona da topologia de exibição muda quando um monitor é removido, um caminho ainda pode ser marcado como ativo, mesmo que o monitor tenha sido removido. Nesse caso, targetAvailable pode ser FALSE para um caminho ativo. Normalmente, essa é uma situação transitória que mudará depois que o sistema operacional tomar medidas na remoção do monitor.

statusFlags

Um OR bit a bit de valores de sinalizador que indica o status do destino. Os seguintes valores têm suporte:

Valor	Significado
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	O destino está em uso em um caminho ativo.
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	A saída pode ser forçada nesse destino mesmo se um monitor não for detectado.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	No momento, a saída está sendo forçada de uma maneira persistente de inicialização.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	No momento, a saída está sendo forçada de maneira persistente.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	No momento, a saída está sendo forçada de maneira não persistente.
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	A saída é um HMD (head-mounted display). Esse caminho só é retornado de QueryDisplayConfig usando o sinalizador QDC_INCLUDE_HMD. Com suporte a partir do Atualização do Windows 10 para Criadores (versão 1703).

Comentários

Uma estrutura DISPLAYCONFIG_PATH_TARGET_INFO é especificada no membro targetInfo de uma estrutura DISPLAYCONFIG_PATH_INFO .

Um destino corresponde ao número de saídas de vídeo possíveis em um adaptador de vídeo. Esse número, no entanto, não equivale ao número de conectores físicos no adaptador de exibição. Cada conector expõe vários destinos que incluem compatibilidade com versões anteriores com tecnologia de conector mais antiga. Por exemplo, um conector DVI expõe um destino DVI, bem como um destino VGA. Um conector DisplayPort, que foi introduzido em 2006, expõe os destinos DisplayPort, HDMI, DVI, TV herdada e VGA.

O membro statusFlags é definido quando você chama a função QueryDisplayConfig .