Funzione WdfVerifierDbgBreakPoint (wdfverifier.h)

[Si applica a KMDF e UMDF]

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

Sintassi

void WdfVerifierDbgBreakPoint();

Valore restituito

Nessuno

Osservazioni

La funzione WdfVerifierDbgBreakPoint si interrompe in un debugger del kernel se una delle condizioni seguenti è vera:

• dbgBreakOnError è impostato su un valore diverso da zero nel Registro di sistema.
• VerifierOn è impostato su un valore diverso da zero e l' DbgBreakOnError non è impostato.
• Driver Verifier è abilitato, il driver è stato compilato con framework versione 1.9 o successiva e non è stato impostato né 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 il debug dei driver Framework-Based.

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

Esempi

Nell'esempio di codice seguente viene illustrato come un driver potrebbe gestire un errore per ottenere un buffer di output di una 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;
}

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfverifier.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Qualsiasi livello
regole di conformità DDI	DriverCreate(kmdf)

Vedere anche

WdfVerifierKeBugCheck