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

Структура, передаваемая драйверу в аргументе pPrivateDriverData объекта DxgkDdiRecommendFunctionalVidPn, которую драйвер должен использовать для описания цветового пространства и формата провода, которые невозможно легко описать в VidPn в сборках DDI.

Синтаксис

typedef struct _DXGK_INHERITED_TIMING_INFO {
  union {
    D3DDDI_COLOR_SPACE_TYPE             OutputColorSpace;
    D3DDDI_OUTPUT_WIRE_COLOR_SPACE_TYPE OutputWireColorSpace;
  };
  D3DKMDT_WIRE_FORMAT_AND_PREFERENCE SelectedWireFormat;
  union {
    struct {
      DXGK_GLITCH_CAUSE    GlitchCause;
      DXGK_GLITCH_EFFECT   GlitchEffect;
      DXGK_GLITCH_DURATION GlitchDuration;
      UINT8                Reserved;
    };
    UINT DiagnosticInfo;
  };
} DXGK_INHERITED_TIMING_INFO, *PDXGK_INHERITED_TIMING_INFO;

Члены

OutputColorSpace

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

OutputWireColorSpace

SelectedWireFormat

Значение D3DKMDT_WIRE_FORMAT_AND_PREFERENCE, указывающее фактически используемый формат провода. Хотя целевой режим, закрепленный в VidPn, возвращаемом вызовом DxgkDdiRecommendFunctionalVidPn, может потребоваться для описания только одного формата провода, что может потребовать от драйвера подготовить специальный целевой режим только для загрузочного случая. Вместо этого это поле должно использоваться для передачи данных о текущем формате кодировки провода и битах на канал цвета. Любой формат, указанный в этом поле, также должен быть указан как поддерживаемый в целевом режиме, сообщаемом через DxgkDdiRecommendFunctionalVidPn.

GlitchCause

Значение DXGK_GLITCH_CAUSE, указывающее, какие базовые изменения или изменения в конвейере отображения вызвали у пользователя ощутимый сбой.

GlitchEffect

Значение DXGK_GLITCH_EFFECT, указывающее, как выглядел сбой для пользователя.

GlitchDuration

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

Reserved

Это значение зарезервировано для системного использования.

DiagnosticInfo

Набор сведений, заполненных драйвером для дисплея загрузки, чтобы описать любые побочные эффекты DxgkDdiStartDevice.

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

Требования

Требование Значение
Заголовок d3dkmddi.h