Функция EngDebugPrint (winddi.h)

Статья
08/27/2023

Функция EngDebugPrint выводит указанное сообщение отладки в отладчик ядра.

Синтаксис

ENGAPI VOID EngDebugPrint(
  [in] PCHAR   StandardPrefix,
  [in] PCHAR   DebugMessage,
  [in] va_list ap
);

Параметры

[in] StandardPrefix

Указатель на строку, которая добавляется в начало DebugMessage.

[in] DebugMessage

Указатель на строку, содержащую сообщение отладки для печати.

[in] ap

Задает список аргументов переменной.

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

None

Remarks

EngDebugPrint полезен для отладки драйверов, которые находятся в разработке. Он выводит StandardPrefix, а затем DebugMessage, в отладчик ядра.

Параметр StandardPrefix выступает в качестве уникального идентификатора драйвера, выполняющего инструкцию отладки; Поэтому одна и та же строка должна использоваться для всех вызовов EngDebugPrint одним драйвером.

Параметр DebugMessage является переменным аргументом ASCII C string; то есть он может содержать как обычные символы, так и спецификации преобразования в стиле C. Список аргументов, содержащийся в ap, может содержать любое количество аргументов любого типа.

Ниже приведен пример использования EngDebugPrint :

#define STANDARD_DEBUG_PREFIX     "Permedia: "
LONG bank;
LONG width;
...
VOID MyDebugPrint(PCHAR DebugMessage, ...)
{
    va_list ap;

    va_start(ap, DebugMessage);
    EngDebugPrint(STANDARD_DEBUG_PREFIX, DebugMessage, ap);
    va_end(ap);
}
...
MyDebugPrint("Bank: %lx; Width: %ld", bank, width);

Примечание Пакет драйверов Microsoft Windows (WDK) не содержит примеры драйверов дисплея Permedia (3dlabs.htm и Perm3.htm) и FrameBuffer (Framebuf.htm). Эти примеры драйверов можно получить из пакета средств разработки драйверов (DDK) для Windows Server 2003 с пакетом обновления 1 (SP1), который можно скачать на странице комплекта средств разработки драйверов для Windows на веб-сайте WDHC.

Требования


Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys

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

EngDebugBreak

Поделиться через