Funzione WdfVerifierDbgBreakPoint (wdfverifier.h)

Articolo
02/29/2024

[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 VerifierOn né DbgBreakOnError .

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

Condividi tramite