функция обратного вызова PFND3DWDDM1_3DDI_SETMARKERMODE (d3d10umddi.h)

  • Статья

Уведомляет драйвер отображения пользовательского режима о том, что он должен поддерживать тип события трассировки событий Windows (ETW). Должен быть реализован с помощью драйверов Windows Display Driver Model (WDDM) 1.3 и более поздних версий.

Синтаксис

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст).

Type

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

Flags

Значение UINT, указывающее, должен ли драйвер предоставлять пользовательские сведения в буферах команд. Если задано значение D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, драйвер должен добавлять заметки и инструментировать буферы команд с пользовательскими сведениями о событиях. В противном случае драйвер не должен примечать к буферам команд.

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

Возвращаемое значение

None

Remarks

Драйвер может использовать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки.

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

  • Используйте упрощенное инструментирование, которое не обеспечивает строгого корреляции с границами команд графики.
  • Драйвер должен иметь возможность выборки метки времени GPU в конце графического конвейера.
  • Не используйте команды выборки, которые накладывают нагрузку на графический конвейер с высокой производительностью, например команды ожидания простоя. Чтобы иметь возможность инструментировать события маркеров профиля, драйверу не нужно очищать конвейер или кэши.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1,WDDM 1.3 и более поздних версий
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть d3d10umddi.h (включая D3d10umddi.h)

См. также раздел

D3DWDDM1_3DDI_MARKER_TYPE