Compartilhar via

Função EngDebugPrint (winddi.h)

  • Artigo

A função EngDebugPrint imprime a mensagem de depuração especificada no depurador de kernel.

Sintaxe

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

Parâmetros

[in] StandardPrefix

Ponteiro para uma cadeia de caracteres que é acrescentada a DebugMessage.

[in] DebugMessage

Ponteiro para uma cadeia de caracteres que contém a mensagem de depuração a ser impressa.

[in] ap

Especifica a lista de argumentos variáveis.

Valor retornado

Nenhum

Comentários

EngDebugPrint é útil para depurar drivers que estão em desenvolvimento. Ele imprime StandardPrefix, seguido por DebugMessage, no depurador de kernel.

O parâmetro StandardPrefix atua como um identificador exclusivo do driver que executa a instrução de depuração; portanto, a mesma cadeia de caracteres deve ser usada para todas as chamadas para EngDebugPrint por um único driver.

O parâmetro DebugMessage é uma cadeia de caracteres ASCII C de argumento variável; ou seja, ele pode conter caracteres comuns e especificações de conversão de estilo C. A lista de argumentos contida no ap pode ter qualquer número de argumentos de qualquer tipo nele.

Um exemplo de uso de EngDebugPrint segue:

#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 O WDK (Microsoft Windows Driver Kit) não contém os drivers de exibição de exemplo Permedia (3dlabs.htm e Perm3.htm) e FrameBuffer (Framebuf.htm ). Você pode obter esses drivers de exemplo do DDK (Kit de Desenvolvimento de Driver do Windows Server 2003 SP1), que você pode baixar na página DDK – Windows Driver Development Kit do site do WDHC.
 

Requisitos

   
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

EngDebugBreak