estructura DISPLAYCONFIG_PATH_TARGET_INFO (wingdi.h)
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:
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 .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en el cliente de Windows 7. |
| Encabezado | wingdi.h (incluye Windows.h) |
Consulte también
DISPLAYCONFIG_SCANLINE_ORDERING
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY