Fonction EngDebugPrint (winddi.h)

Article
08/27/2023

La fonction EngDebugPrint imprime le message de débogage spécifié dans le débogueur du noyau.

Syntaxe

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

Paramètres

[in] StandardPrefix

Pointeur vers une chaîne qui est ajoutée à DebugMessage.

[in] DebugMessage

Pointeur vers une chaîne contenant le message de débogage à imprimer.

[in] ap

Spécifie la liste d’arguments de variable.

Valeur de retour

None

Remarques

EngDebugPrint est utile pour déboguer les pilotes en cours de développement. Il imprime StandardPrefix, suivi de DebugMessage, dans le débogueur du noyau.

Le paramètre StandardPrefix agit comme identificateur unique du pilote exécutant l’instruction de débogage ; Par conséquent, la même chaîne doit être utilisée pour tous les appels à EngDebugPrint par un seul pilote.

Le paramètre DebugMessage est une chaîne C ASCII d’argument variable ; Autrement dit, il peut contenir à la fois des caractères ordinaires et des spécifications de conversion de style C. La liste d’arguments contenue dans ap peut contenir n’importe quel nombre d’arguments de n’importe quel type.

Voici un exemple d’utilisation de 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);

Note Le Kit de pilotes Microsoft Windows (WDK) ne contient pas les exemples de pilotes d’affichage Permedia (3dlabs.htm et Perm3.htm) et FrameBuffer (Framebuf.htm). Vous pouvez obtenir ces exemples de pilotes à partir du Kit de développement de pilotes (DDK) Windows Server 2003 SP1, que vous pouvez télécharger à partir de la page DDK - Kit de développement de pilotes Windows du site web WDHC.

Configuration requise


Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winddi.h (inclure Winddi.h)
Bibliothèque	Win32k.lib
DLL	Win32k.sys

Voir aussi

EngDebugBreak

Partager via