estructura DISPLAYCONFIG_PATH_TARGET_INFO (wingdi.h)

Artículo
03/13/2024

La estructura DISPLAYCONFIG_PATH_TARGET_INFO contiene información de destino para una única ruta de acceso.

Sintaxis

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;

Miembros

adapterId

Identificador del adaptador en el que se encuentra la ruta de acceso.

id

Identificador de destino del adaptador especificado al que se relaciona esta ruta de acceso.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

Índice válido en la tabla de información del modo que contiene la información del modo de destino de esta ruta de acceso solo cuando no se establece DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE. Si la información del modo de destino no está disponible, el valor de modeInfoIdx es DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

Índice válido en la matriz de modo de la entrada DISPLAYCONFIG_DESKTOP_IMAGE_INFO que contiene la información del modo de escritorio de esta ruta de acceso solo cuando se establece DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE. Si no hay ninguna entrada para esto en la matriz de modo, el valor de desktopModeInfoIdx es DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Se admite a partir de Windows 10.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

Índice válido en la matriz de modo de la entrada DISPLAYCONFIG_TARGET_MODE que contiene la información del modo de destino de esta ruta de acceso solo cuando se establece DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE. Si no hay ninguna entrada para esto en la matriz de modo, el valor de targetModeInfoIdx es DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Se admite a partir de Windows 10.

outputTechnology

Tipo de conector del destino. Para obtener una lista de los valores posibles, consulte el tipo enumerado DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY .

rotation

Valor que especifica la rotación del destino. Para obtener una lista de los valores posibles, consulte el DISPLAYCONFIG_ROTATION tipo enumerado.

scaling

Valor que especifica cómo se escala la imagen de origen al destino. Para obtener una lista de los valores posibles, consulte el tipo enumerado DISPLAYCONFIG_SCALING . Para obtener más información sobre el escalado, consulte Escalado de la imagen de escritorio.

refreshRate

Estructura DISPLAYCONFIG_RATIONAL que especifica la frecuencia de actualización del destino. Si el autor de la llamada especifica información del modo de destino, el sistema operativo usará en su lugar la frecuencia de actualización almacenada en el miembro vSyncFreq de la estructura DISPLAYCONFIG_VIDEO_SIGNAL_INFO . En este caso, el llamador especifica este valor en el miembro targetVideoSignalInfo de la estructura DISPLAYCONFIG_TARGET_MODE . Una frecuencia de actualización con el numerador y el denominador establecidos en cero indica que el autor de la llamada no especifica una frecuencia de actualización y el sistema operativo debe usar la frecuencia de actualización más óptima disponible. En este caso, en una llamada a la función SetDisplayConfig , el autor de la llamada debe establecer el miembro scanLineOrdering en el valor DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED; De lo contrario, se produce un error en SetDisplayConfig .

scanLineOrdering

Valor que especifica el orden de línea de examen de la salida en el destino. Para obtener una lista de los valores posibles, vea el tipo enumerado DISPLAYCONFIG_SCANLINE_ORDERING . Si el autor de la llamada especifica información del modo de destino, el sistema operativo usará en su lugar el orden de línea de examen almacenado en el miembro scanLineOrdering de la estructura DISPLAYCONFIG_VIDEO_SIGNAL_INFO . En este caso, el llamador especifica este valor en el miembro targetVideoSignalInfo de la estructura DISPLAYCONFIG_TARGET_MODE .

targetAvailable

Valor booleano que especifica si el destino está disponible. TRUE indica que el destino está disponible.

Dado que la naturaleza asincrónica de la topología de visualización cambia cuando se quita un monitor, es posible que una ruta de acceso se marque como activa aunque se haya quitado el monitor. En tal caso, targetAvailable podría ser FALSE para una ruta de acceso activa. Normalmente se trata de una situación transitoria que cambiará después de que el sistema operativo tome medidas en la eliminación del monitor.

statusFlags

Or bit a bit de valores de marca que indica el estado del destino. Se admiten los valores siguientes:

Valor	Significado
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	El destino está en uso en una ruta de acceso activa.
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	La salida se puede forzar en este destino incluso si no se detecta un monitor.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	La salida se está obligando actualmente de forma persistente al arranque.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	La salida se está obligando actualmente de forma persistente a la ruta de acceso.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	La salida se está obligando actualmente de forma no persistente.
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	La salida es una pantalla montada en la cabeza (HMD). Esta ruta de acceso solo se devuelve de QueryDisplayConfig con la marca QDC_INCLUDE_HMD. Se admite a partir de la Windows 10 Creators Update (versión 1703).

Comentarios

Se especifica una estructura DISPLAYCONFIG_PATH_TARGET_INFO en el miembro targetInfo de una estructura de DISPLAYCONFIG_PATH_INFO .

Un destino corresponde al número de posibles salidas de vídeo en un adaptador de pantalla. Sin embargo, este número no equivale al número de conectores físicos en el adaptador de pantalla. Cada conector expone una serie de destinos que incluyen compatibilidad con versiones anteriores con la tecnología de conector anterior. Por ejemplo, un conector DVI expone un destino DVI, así como un destino VGA. Un conector DisplayPort, que se introdujo en 2006, expone los destinos DisplayPort, HDMI, DVI, TV heredado y VGA.

El miembro statusFlags se establece cuando se llama a la función QueryDisplayConfig .