Metodo IWDFIoQueue::P urge (wudfddi.h)

Articolo
02/07/2025

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

Il metodo ripulitura indirizza il framework a rifiutare le nuove richieste di I/O in ingresso e ad annullare tutte le richieste in sospeso.

Sintassi

void Purge(
  [in, optional] IQueueCallbackStateChange *pPurgeComplete
);

Parametri

[in, optional] pPurgeComplete

Puntatore all'interfaccia IQueueCallbackStateChange il cui metodo chiama il framework per recapitare lo stato della coda al driver. Il framework chiama il metodo dopo che tutte le richieste vengono annullate. Questo parametro è facoltativo e può essere NULL.

Valore restituito

Nessuno

Osservazioni

Il framework annulla le richieste non elaborate nella coda. Per le richieste recapitate al driver e contrassegnate come annullabili, il framework chiama IRequestCallbackCancel::OnCancel.

Il driver deve assicurarsi che sia in corso solo uno dei metodi seguenti in qualsiasi momento:

Ad esempio, se il driver precedentemente chiamato Purge, deve attendere la notifica dal metodo dell'interfaccia a cui punta il parametro pPurgeComplete prima di chiamare Stop o Drain. La violazione di questa regola comporta la chiusura del processo host.

Esempi

Nell'esempio di codice seguente viene illustrato come arrestare le richieste a una coda.

VOID
CUmdfHidFile::OnCleanupFile(
    __in IWDFFile* /* WdfFile */
    )
/*++
    This method handles the cleanup operation for the file object.  
    Because the file is disabled, no new reports should be added to the ring buffer.
--*/
{
    this->Disable();

    //
    // Stop all current requests to read reports.
    //

    m_GetReportQueue->Purge(NULL);
}

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.5
intestazione	wudfddi.h (include Wudfddi.h)
dll	WUDFx.dll