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