Função WdfVerifierKeBugCheck (wdfverifier.h)

[Aplica-se a KMDF e UMDF]

A função WdfVerifierKeBugCheck cria uma verificação de bug.

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 verificação de bugs definidos noBugcodes.h.

[in] BugCheckParameter1

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

[in] BugCheckParameter2

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

[in] BugCheckParameter3

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

[in] BugCheckParameter4

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

Valor de retorno

Nenhum

Observações

Se o driver KMDF (Kernel-Mode Driver Framework) chamar WdfVerifierKeBugCheck, o sistema operacional interromperá e exibirá uma tela azul a menos que um depurador esteja em execução. Para obter mais informações, consulte Introdução ao WinDbg – modo kernel.

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 uma estiver conectada. 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 os erros de relatórios do UMDF.

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

Exemplos

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

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

Requisitos

Consulte também

WdfVerifierDbgBreakPoint