estrutura DISPLAYCONFIG_PATH_TARGET_INFO (wingdi.h)
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:
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 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Cliente do Windows 7. |
| Cabeçalho | wingdi.h (inclua Windows.h) |
Confira também
DISPLAYCONFIG_SCANLINE_ORDERING
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY