Средства тестирования драйверов

Обзор технологии средств тестирования драйверов.

Для разработки средств тестирования драйвера вам потребуется следующее:

• wpprecorder.h

Руководство по программированию см. в средствах тестирования driver.

Макросы

Заголовок	Описание
макрос WppRecorderConfigure	Метод WppRecorderConfigure включает или отключает журнал по умолчанию, в который выполняется печать WPP.
макрос WppRecorderDumpLiveDriverData	Метод WppRecorderDumpLiveDriverData получает буфер, связанный с указанным журналом записи трассировки inflight.
макрос WppRecorderGetTriageInfo	The WppRecorderGetTriageInfo.
макрос WppRecorderLinkCounters	The WppRecorderLinkCounters.
макрос WppRecorderLogCreate	Метод WppRecorderLogCreate создает буфер для хранения журнала записей.
макрос WppRecorderLogDelete	Метод WppRecorderLogDelete удаляет указанный журнал записей.
макро с WppRecorderLogSetIdentifier	Метод WppRecorderLogSetIdentifier задает строковый идентификатор для журнала записей.

Перечисления

FAULT_INFORMATION_ARCH Определяет значения для типа системной архитектуры.
FAULT_INFORMATION_ARM64_TYPE Определяет значения типа сбоя.
PCW_CALLBACK_TYPE Перечисление PCW_CALLBACK_TYPE определяет тип уведомления для отправки зарегистрированным поставщику набора счетчиков. Поставщик передает указатель на это перечисление в качестве параметра функции PcwCallback.
WPP_RECORDER_TRI_STATE Тип перечисления WPP_RECORDER_TRI_STATE определяет три значения, которые WPP использует для некоторых элементов структуры и параметров функции.

Функции

ASSERTMSG ASSERTMSG проверяет выражение. Если выражение равно false, оно разбивается на отладчик ядра и отправляет его указанное сообщение.
DbgBreakPoint Подпрограмма DbgBreakPoint прерывается в отладчик ядра.
DbgBreakPointWithStatus Подпрограмма DbgBreakPointWithStatus прерывается в отладчик ядра и отправляет значение status в отладчик.
DbgPrint Подпрограмма DbgPrint отправляет сообщение отладчику ядра.
DbgPrintEx Подпрограмма DbgPrintEx отправляет строку в отладчик ядра, если выполнены указанные условия.
DbgPrompt Подпрограмма DbgPrompt отображает строку запроса пользователя, указанную вызывающим пользователем, на отображающем устройстве отладчика ядра и получает строку ответа пользователя.
EtwActivityIdControl Функция EtwActivityIdControl создает, запрашивает и задает текущий идентификатор действия.
ETWENABLECALLBACK Функция EtwEnableCallback — это необязательная функция обратного вызова, предоставляемая драйвером, которая используется для получения уведомлений о включении или отключении.
EtwEventEnabled Функция EtwEventEnabled проверяет, включено ли событие.
EtwProviderEnabled Функция EtwProviderEnabled проверяет, включен ли поставщик для ведения журнала событий на указанном уровне и ключевом слове.
EtwRegister Функция EtwRegister регистрирует поставщика событий и должна вызываться, прежде чем поставщик сможет начать трассировку.
EtwUnregister Функция EtwUnregister отменяет регистрацию поставщика событий и должна вызываться перед выходом поставщика.
EtwWrite Функция EtwWrite — это функция трассировки для публикации событий в коде драйвера в режиме ядра.
EtwWriteEx Функция EtwWriteEx — это функция трассировки для публикации событий, поддерживающих фильтрацию в коде драйвера в режиме ядра.
EtwWriteString Функция EventWriteString — это функция трассировки, которую можно использовать при отсутствии сложных данных. Эта функция аналогична инструкции отладки печати.
EtwWriteTransfer Функция EtwWriteTransfer отмечает событие, которое связывает две действия вместе; этот тип события называется событием передачи.
imp_WppRecorderGetCounterHandle Метод WppRecorderGetCounterHandle.
imp_WppRecorderIsDefaultLogAvailable Метод WppRecorderIsDefaultLogAvailable определяет, доступен ли журнал по умолчанию.
imp_WppRecorderLogGetDefault Метод WppRecorderLogGetDefault получает дескриптор журнала записи по умолчанию.
KdBreakPointWithStatus Макрос KdBreakPointWithStatus разбивается на отладчик ядра и отправляет значение состояния отладчику.
KdChangeOption Подпрограмма KdChangeOption обращается и изменяет состояние в ядре, связанном с отладкой ядра.
KdDisableDebugger Подпрограмма KdDisableDebugger отключает отладчик ядра.
KdEnableDebugger Подпрограмма KdEnableDebugger повторно включает отладчик ядра после вызова подпрограммы KdDisableDebugger отключает отладчик ядра.
KdPrint Макрос KdPrint отправляет сообщение отладчику ядра.
KdPrintEx Макрос KdPrintEx отправляет строку в отладчик ядра, если указаны условия. Для вызова KdPrintEx требуются двойные скобки.
KdRefreshDebuggerNotPresent Макрос KdRefreshDebuggerNotPresent обновляет значение глобальной переменной ядра KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray Инициализирует массив блоков данных дампа триажа.
PCW_CALLBACK Поставщики могут реализовать функцию PCW_CALLBACK для получения уведомлений, когда потребители выполняют определенные действия, например добавление или удаление счетчиков из запроса.
PcwAddInstance Функция PcwAddInstance добавляет указанный экземпляр счетчика в буфер потребителя.
PcwCloseInstance Функция PcwCloseInstance закрывает указанный экземпляр набора счетчиков.
PcwCreateInstance Функция PcwCreateInstance создает новый экземпляр для указанного зарегистрированного счетчика.
PcwRegister Функция PcwRegister регистрирует вызывающий объект в качестве поставщика указанного набора счетчиков.
PcwUnregister Функция PcwUnregister отменяет регистрацию поставщика указанного набора счетчиков.
RECORDER_CONFIGURE_PARAMS_INIT Функция RECORDER_CONFIGURE_PARAMS_INIT используется для инициализации структуры RECORDER_CONFIGURE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT Функция RECORDER_LOG_CREATE_PARAMS_INIT используется для инициализации структуры RECORDER_LOG_CREATE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER Метод RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER инициализирует RECORDER_LOG_CREATE_PARAMS указателем для связывания журналов.
SeEtwWriteKMCveEvent Функция SeEtwWriteKMCveEvent — это функция трассировки для публикации событий при обнаружении эксплойта уязвимостей безопасности в драйверах режима ядра.
vDbgPrintEx Подпрограмма vDbgPrintEx отправляет строку отладчику ядра, если выполнены определенные условия.
vDbgPrintExWithPrefix Подпрограмма vDbgPrintExWithPrefix отправляет строку в отладчик ядра, если выполнены определенные условия. Эта подпрограмма может добавить префикс к выходным данным отладчика, чтобы упорядочить результаты отладки.
WppRecorderConfigure Узнайте, как метод WppRecorderConfigure включает или отключает журнал по умолчанию для печати WPP.
WppRecorderDumpLiveDriverData Узнайте, как метод WppRecorderDumpLiveDriverData получает буфер, связанный с указанным журналом записи трассировки inflight.
WppRecorderGetTriageInfo Узнайте о методе WppRecorderGetTriageInfo.
WppRecorderLinkCounters Узнайте, как метод WppRecorderLinkCounters использует порядковый номер для слияния журналов, захваченных в разных буферах драйвером.
WppRecorderLogCreate Узнайте, как метод WppRecorderLogCreate создает буфер для хранения журнала записей.
WppRecorderLogDelete Узнайте, как метод WppRecorderLogDelete удаляет указанный журнал записей.
WppRecorderLogDumpLiveData Метод WppRecorderLogDumpLiveData возвращает непрозрачный указатель на заголовок буфера журнала и данные, чтобы их можно было сохранить в динамическом аварийном выполнении.
WppRecorderLogSetIdentifier Узнайте, как метод WppRecorderLogSetIdentifier задает строковый идентификатор для журнала записи.

Структуры

DEBUG_DEVICE_DESCRIPTOR Дополнительные сведения: структура DEBUG_DEVICE_DESCRIPTOR
DEBUG_TRANSPORT_DATA Описывает данные, относящиеся к отладочному транспорту для использования транспортом.
FAULT_INFORMATION Содержит сведения, чтобы задать отчет об ошибке на устройстве.
FAULT_INFORMATION_ARM64 Содержит сведения об ошибке для системы ARM64.
FAULT_INFORMATION_ARM64_FLAGS Определяет сведения об ошибке.
KBUGCHECK_CALLBACK_RECORD Дополнительные сведения: структура KBUGCHECK_CALLBACK_RECORD
KBUGCHECK_REASON_CALLBACK_RECORD Дополнительные сведения: структура KBUGCHECK_REASON_CALLBACK_RECORD
KBUGCHECK_REMOVE_PAGES Описывает одну или несколько страниц предоставленных драйвером данных, которые будут удалены из файла аварийного дампа KBUGCHECK_REASON_CALLBACK_ROUTINE подпрограммой обратного вызова.
KBUGCHECK_SECONDARY_DUMP_DATA_EX Дополнительные сведения: структура _KBUGCHECK_SECONDARY_DUMP_DATA_EX
KBUGCHECK_TRIAGE_DUMP_DATA Дополнительные сведения: структура _KBUGCHECK_TRIAGE_DUMP_DATA
KTRIAGE_DUMP_DATA_ARRAY Дополнительные сведения: структура _KTRIAGE_DUMP_DATA_ARRAY
MCG_CAP Дополнительные сведения: структура MCG_CAP
PCW_CALLBACK_INFORMATION Союз PCW_CALLBACK_INFORMATION предоставляет сведения о отправке уведомления. Поставщик передает указатель на этот союз в качестве параметра функции PcwCallback.
PCW_COUNTER_DESCRIPTOR Структура PCW_COUNTER_DESCRIPTOR предоставляет сведения о отправке уведомления.
PCW_COUNTER_INFORMATION Структура PCW_COUNTER_INFORMATION описывает атрибуты, определяющие конкретный экземпляр набора счетчиков.
PCW_DATA Структура PCW_DATA описывает массив блоков данных, связанных с экземпляром.
PCW_MASK_INFORMATION Структура PCW_MASK_INFORMATION предоставляет сведения о уведомлении для отправки поставщику. Эти сведения передаются как часть параметра Info в функцию PcwCallback. Эта информация маски включена в PCW_CALLBACK_INFORMATION.
PCW_REGISTRATION_INFORMATION Структура PCW_REGISTRATION_INFORMATION предоставляет сведения о поставщике и наборе счетчиков.
RECORDER_CONFIGURE_PARAMS Структура RECORDER_CONFIGURE_PARAMS является входным параметром метода WppRecorderConfigure, чтобы включить или отключить журнал по умолчанию, в который выполняется печать WPP.
RECORDER_LOG_CREATE_PARAMS Структура RECORDER_LOG_CREATE_PARAMS является входным параметром метода WppRecorderLogCreate.
WPP_TRIAGE_INFO Используется для поиска журнала WPP для отчетов WER.