функция обратного вызова 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, драйвер должен отметать и инструментировать буферы команд с пользовательскими сведениями о событии. В противном случае драйвер не должен замечать буферы команд.
Заметка может быть в виде текстовой строки в языковом стандарте English-US или в виде значения индекса в расположение в строковой таблице. Для последнего параметра драйвер также должен реализовать функцию, описывающую строки, которые указывают значения индекса.
Возвращаемое значение
Никакой
Замечания
Драйвер может использовать функцию обратного вызова pfnSetErrorCb для задания кода ошибки.
Следуйте этим рекомендациям при настройке событий маркера профиля в драйвере пользовательского режима, указанном в типе D3DWDDM1_3DDI_MARKER_TYPE_PROFILE:
- Используйте упрощенное инструментирование, которое не создает сильную корреляцию с границами графических команд.
- Драйвер должен иметь возможность выборки метки времени GPU в конце графического конвейера.
- Не используйте команды выборки, которые размещают высокую производительность в графическом конвейере, например команды ожидания ожидания бездействия. Чтобы иметь возможность инструментировать события маркера типа профиля, драйверу не нужно удалять конвейер или кэши.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8.1,WDDM 1.3 и более поздних версий |
| минимальный поддерживаемый сервер | Windows Server 2012 R2 |
| целевая платформа | Настольный |
| заголовка | d3d10umddi.h (include D3d10umddi.h) |