Função WdfVerifierKeBugCheck (wdfverifier.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

A função WdfVerifierKeBugCheck cria um bug marcar.

Sintaxe

void WdfVerifierKeBugCheck(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

Parâmetros

[in] BugCheckCode

Um dos códigos de marcar de bugs definidos em Bugcodes.h.

[in] BugCheckParameter1

Para obter informações sobre esse parâmetro, consulte o bug especificado marcar descrição do código.

[in] BugCheckParameter2

Para obter informações sobre esse parâmetro, consulte o bug especificado marcar descrição do código.

[in] BugCheckParameter3

Para obter informações sobre esse parâmetro, consulte o bug especificado marcar descrição do código.

[in] BugCheckParameter4

Para obter informações sobre esse parâmetro, consulte o bug especificado marcar descrição do código.

Retornar valor

Nenhum

Comentários

Se o driver do Kernel-Mode Driver Framework (KMDF) chamar WdfVerifierKeBugCheck, o sistema operacional será interrompido e exibirá uma tela azul , a menos que um depurador esteja em execução.

Se o driver do UMDF (User-Mode Driver Framework) (versão 2.0 ou posterior) chamar WdfVerifierKeBugCheck, a estrutura não usará os parâmetros fornecidos pelo driver. Nesse caso, a estrutura será dividida no depurador se um estiver conectado. Se um depurador não estiver conectado, a estrutura gerará uma exceção e o manipulador de exceção UMDF padrão criará um arquivo de minidump. Para obter mais informações sobre exceções sem tratamento no processo de host do driver, consulte Como o UMDF relata erros.

Para obter mais informações sobre como depurar o driver, consulte Depurando drivers WDF.

Exemplos

O exemplo de código a seguir cria uma marcar de bugs que usa o código marcar de bug MULTIPLE_IRP_COMPLETE_REQUESTS.

WdfVerifierKeBugCheck(
                      MULTIPLE_IRP_COMPLETE_REQUESTS,
                      (ULONG_PTR) irp,
                      (ULONG_PTR) srb,
                      0,
                      0
                      );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfverifier.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualquer nível
Regras de conformidade de DDI DriverCreate(kmdf)

Confira também

WdfVerifierDbgBreakPoint