Функция DbgBreakPointWithStatus (wdm.h)
Подпрограмма DbgBreakPointWithStatus прерывает работу отладчика ядра и отправляет отладчику значение Status .
Синтаксис
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Параметры
[in] Status
Указывает значение ULONG, которое отправляется отладчику (например, код состояния или адрес).
Возвращаемое значение
None
Remarks
DbgBreakPointWithStatus идентичен DbgBreakPoint, за исключением сообщения о состоянии .
На компьютерах x86 параметр Status хранится в регистре eax . На компьютерах с зарегистрированными соглашениями о вызовах состояние сохраняется в первом регистре аргументов.
Эта подпрограмма вызывает исключение, которое обрабатывается отладчиком ядра, если он установлен; в противном случае он обрабатывается системой отладки. Если отладчик не подключен к системе, исключение можно обработать стандартным способом.
В режиме ядра исключение останова, которое не обрабатывается, вызовет ошибку проверка. Однако можно подключить отладчик в режиме ядра к целевому компьютеру, который перестал отвечать на запросы и для которого включена отладка ядра. Дополнительные сведения см. в разделе Отладка Windows.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версий. |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h) |
| Библиотека | Ntdll.lib (пользовательский режим); NtosKrnl.lib (режим ядра) |
| DLL | NtosKrnl.exe |
| Правила соответствия DDI | DebugBreakUsage(wdm), HwStorPortProhibitedDIs(storport) |