Função WdfVerifierDbgBreakPoint (wdfverifier.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

A função WdfVerifierDbgBreakPoint será dividida em um depurador de kernel, se um depurador estiver em execução.

Sintaxe

void WdfVerifierDbgBreakPoint();

Retornar valor

Nenhum

Comentários

A função WdfVerifierDbgBreakPoint será dividida em um depurador de kernel se um dos seguintes for verdadeiro:

  • DbgBreakOnError é definido como um valor diferente de zero no Registro.
  • VerifierOn é definido como um valor diferente de zero e DbgBreakOnError não está definido.
  • O Verificador de Driver está habilitado, o driver foi criado com a versão 1.9 ou posterior da estrutura e nem VerifierOn nem DbgBreakOnError estão definidos.
Para obter mais informações sobre entradas do Registro que você pode usar para depurar seu driver, consulte Entradas do Registro para Depuração Framework-Based Drivers.

Para obter mais informações sobre como depurar seu driver, consulte Depurando um driver KMDF.

Exemplos

O exemplo de código a seguir mostra como um driver pode lidar com uma falha ao obter o buffer de saída de uma solicitação de E/S.

Status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memory
                                        );
if( !NT_SUCCESS(Status) ) {
    KdPrint(("EvtIoRead could not get request memory buffer. Status: 0x%x\n",Status));
    WdfVerifierDbgBreakPoint();
    WdfRequestCompleteWithInformation(
                                      Request,
                                      Status,
                                      0L
                                      );
    return;
}

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

WdfVerifierKeBugCheck