Funzione WdfVerifierDbgBreakPoint (wdfverifier.h)

[Si applica a KMDF e UMDF]

La funzione WdfVerifierDbgBreakPoint si interrompe in un debugger del kernel, se un debugger è in esecuzione.

Sintassi

void WdfVerifierDbgBreakPoint();

Valore restituito

nessuno

Osservazioni

La funzione WdfVerifierDbgBreakPoint si interrompe in un debugger del kernel se uno dei seguenti è true:

  • DbgBreakOnError è impostato su un valore diverso da zero nel Registro di sistema.
  • VerifierOn è impostato su un valore diverso da zero e DbgBreakOnError non è impostato.
  • Il driver Verifier è abilitato, il driver è stato compilato con framework versione 1.9 o successiva e non è impostato VerifierOnDbgBreakOnError .
Per altre informazioni sulle voci del Registro di sistema che è possibile usare per eseguire il debug del driver, vedere Voci del Registro di sistema per debug Framework-Based driver.

Per altre informazioni sul debug del driver, vedere Debug di un driver KMDF.

Esempio

Nell'esempio di codice seguente viene illustrato come un driver potrebbe gestire un errore per ottenere un buffer di output della richiesta di I/O.

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;
}

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfverifier.h (includere Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualsiasi livello
Regole di conformità DDI DriverCreate(kmdf)

Vedi anche

WdfVerifierKeBugCheck