Funzione EngDebugPrint (winddi.h)

Articolo
08/27/2023

La funzione EngDebugPrint stampa il messaggio di debug specificato nel debugger del kernel.

Sintassi

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

Parametri

[in] StandardPrefix

Puntatore a una stringa anteposta a DebugMessage.

[in] DebugMessage

Puntatore a una stringa contenente il messaggio di debug da stampare.

[in] ap

Specifica l'elenco di argomenti della variabile.

Valore restituito

nessuno

Osservazioni

EngDebugPrint è utile per il debug di driver in fase di sviluppo. Stampa StandardPrefix, seguito da DebugMessage, nel debugger del kernel.

Il parametro StandardPrefix funge da identificatore univoco del driver che esegue l'istruzione di debug; pertanto, la stessa stringa deve essere usata per tutte le chiamate a EngDebugPrint da un singolo driver.

Il parametro DebugMessage è una stringa ASCII C dell'argomento variabile; ovvero può contenere sia i caratteri ordinari che le specifiche di conversione in stile C. L'elenco di argomenti contenuto in ap può contenere un numero qualsiasi di argomenti di qualsiasi tipo.

Di seguito è riportato un esempio di utilizzo di 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);

Nota Microsoft Windows Driver Kit (WDK) non contiene i driver di visualizzazione di esempio Permedia (3dlabs.htm e Perm3.htm) e FrameBuffer (Framebuf.htm). È possibile ottenere questi driver di esempio da Windows Server 2003 SP1 Driver Development Kit (DDK), che è possibile scaricare dalla pagina DDK - Windows Driver Development Kit del sito Web WDHC.

Requisiti


Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys

Vedi anche

EngDebugBreak

Condividi tramite