EngDebugPrint-Funktion (winddi.h)

Artikel
08/27/2023

Die EngDebugPrint-Funktion gibt die angegebene Debugmeldung an den Kerneldebugger aus.

Syntax

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

Parameter

[in] StandardPrefix

Zeiger auf eine Zeichenfolge, die DebugMessage vorangestellt ist.

[in] DebugMessage

Zeiger auf eine Zeichenfolge, die die zu druckende Debugmeldung enthält.

[in] ap

Gibt die Variablenargumentliste an.

Rückgabewert

Keine

Bemerkungen

EngDebugPrint ist nützlich für das Debuggen von Treibern, die sich in der Entwicklung befinden. Es gibt StandardPrefix, gefolgt von DebugMessage, an den Kerneldebugger aus.

Der StandardPrefix-Parameter fungiert als eindeutiger Bezeichner des Treibers, der die Debuganweisung ausführt. Daher sollte dieselbe Zeichenfolge für alle Aufrufe von EngDebugPrint von einem einzelnen Treiber verwendet werden.

Der DebugMessage-Parameter ist eine ASCII-C-Zeichenfolge des Variablenarguments. Das heißt, es kann sowohl normale Zeichen als auch Konvertierungsspezifikationen im C-Stil enthalten. Die in ap enthaltene Argumentliste kann eine beliebige Anzahl von Argumenten eines beliebigen Typs enthalten.

Es folgt eine Beispielverwendung von 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);

Hinweis Das Microsoft Windows Driver Kit (WDK) enthält nicht die Beispieltreiber Permedia (3dlabs.htm und Perm3.htm) und FrameBuffer (Framebuf.htm). Sie können diese Beispieltreiber aus dem Windows Server 2003 SP1 Driver Development Kit (DDK) abrufen, das Sie von der Seite DDK – Windows Driver Development Kit der WDHC-Website herunterladen können.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

EngDebugBreak

Freigeben über