структура DXGK_QUERYINTEGRATEDDISPLAYOUT2 (d3dkmddi.h)

Используется во время запроса для вывода интегрированного отображения.

Синтаксис

typedef struct _DXGK_QUERYINTEGRATEDDISPLAYOUT2 {
  [out] DXGK_INTEGRATEDDISPLAYFLAGS        Flags;
  [out] D3DKMDT_VIDEO_SIGNAL_INFO          NativeTiming;
  [out] DXGK_MONITORLINKINFO_CAPABILITIES  LinkCapabilities;
  [out] DXGK_COLORIMETRY                   Colorimetry;
  [out] DXGK_DISPLAY_TECHNOLOGY            DisplayTechnology;
  [out] DXGK_DISPLAY_USAGE                 IntendedUsage;
  [out] BYTE                               Instance;
  [out] DXGK_DISPLAY_DESCRIPTOR_TYPE       DescriptorType;
  [out] D3DKMDT_WIRE_FORMAT_AND_PREFERENCE DitheringSupport;
} DXGK_QUERYINTEGRATEDDISPLAYOUT2, *PDXGK_QUERYINTEGRATEDDISPLAYOUT2;

Члены

[out] Flags

Указатель на структуру DXGK_INTEGRATEDDISPLAYFLAGS , описывающую простые свойства интегрированного дисплея. Значения ориентации 0 градусов указывают на отсутствие переопределения дескриптора.

[out] NativeTiming

Указатель на структуру [D3DKMDT_VIDEO_SIGNAL_INFO]/d3dkmdt/ns-d3dkmdt-_d3dkmdt_video_signal_info.md), которая содержит сведения о собственном времени интегрированного дисплея. Значение должно быть обнуляться, чтобы указать отсутствие переопределения. Это значение переопределяет собственное время в дескрипторе. Так как драйвер отвечает за предоставление дескриптора, единственное ожидаемое использование этого переопределения заключается в описании времени, которое не может быть описано EDID, наиболее очевидно, дисплеем, который имеет более 4095 адресуемых пикселей в любом направлении. Если указано переопределение NativeTiming, операционная система не будет вызывать DxgkDdiRecommendMonitorModes для этого целевого объекта. Как правило, интегрированные панели не поддерживают большой набор времени, и драйвер должен хорошо соответствовать предоставленному идентификатору EDID. Если драйверу необходимо описать несколько переопределений для режимов мониторинга, ему следует оставить структуру NativeTiming нулевой и сообщить обо всех переопределениях с помощью DxgkDdiRecommendMonitorModes.

[out] LinkCapabilities

Указатель на структуру DXGK_MONITORLINKINFO_CAPABILITIES , описывающую возможности связи для управления монитором. Это те же возможности связи, что и операционная система будет запрашивать с внешнего дисплея после горячего подключения. Так как встроенный дисплей предоставляется во время инициализации драйвера адаптера, возможности описываются напрямую, а не дополнительный вызов DDI.

Начиная с WDDM 2.6, этот элемент используется для создания отчетов о поддержке синхронизации.

[out] Colorimetry

Переопределения, связанные с цветом, для дисплея. Определения полей и ограничения для сочетаний полей см. в описании DXGK_COLORIMETRY .

[out] DisplayTechnology

Значение, представляющее технологию отображения. Используется для оптимизации взаимодействия, например включение темной темы с уменьшенным синим содержимым на DXGK_DT_OLED дисплеях.

[out] IntendedUsage

Значение, указывающее предполагаемое использование дисплея производителем. Сообщаемое значение должно быть DXGK_DU_GENERIC, если драйвер не содержит сведения, указывающие на более конкретное использование. Предполагается, что если встроенный дисплей предназначен для использования для ar, VR или вспомогательных выходных данных, драйвер должен иметь достаточно конкретной обработки, чтобы он мог сообщить о правильном использовании.

[out] Instance

Отсчитываемое от нуля целое число для экземпляра интегрированной панели. Используется для заказа нескольких интегрированных панелей. Значения должны быть уникальными и непрерывными для интегрированных целевых объектов, но не должны сообщаться по порядку.

[out] DescriptorType

Значение, указывающее тип дескриптора. Для WDDM 2.4 это значение должно быть DXGK_DDT_EDID. В WDDM 2.5 и более поздних версиях разрешено DXGK_DDT_EDID или DXGK_DDT_DISPLAYID.

[out] DitheringSupport

Поле D3DKMDT_WIRE_FORMAT_AND_PREFERENCE , содержащее флаги для каждого проводного формата. Драйвер должен задать бит проводного формата для каждого формата, в котором драйвер и оборудование поддерживают дизеринг, полезный для качества изображения, если исходный формат пикселей имеет более высокую точность, чем проводной формат.

Комментарии

Поля предоставляют переопределяющие атрибуты отображения, которые могут быть предоставлены дескриптором, но не могут быть описаны с помощью EDID или обычно отсутствуют или неверны в EDID. Если между дескриптором и этими полями переопределения возникает конфликт, ОС будет использовать переопределения, если они допустимы.

Операционная система будет иметь здравый проверка поля и не сможет запустить драйвер, если какие-либо поля будут признаны несогласованными или недопустимыми. Для большинства полей проверка работоспособности просто означает, что сообщаемые значения находятся в диапазоне, но поля Colorimetry, Instance и Descriptor применяются к дальнейшей проверке. Сведения о colorimetry см. в описании DXGK_COLORIMETRY для проверки. Значения экземпляров проверяются на согласованность на всех интегрированных дисплеях, как указано выше. Дескриптор должен быть допустимым EDID.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1803
Верхняя часть d3dkmddi.h