Condividi tramite


Metodo IWDFIoQueue::D rain (wudfddi.h)

[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 Drain indirizza la coda a rifiutare le nuove richieste di I/O in ingresso e consentire il recapito delle richieste già in coda al driver per l'elaborazione.

Sintassi

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

Parametri

[in, optional] pDrainComplete

Puntatore all'interfaccia IQueueCallbackStateChange il cui metodo chiama il framework per recapitare lo stato della coda al driver. Il framework chiama il metodo dopo il completamento o l'annullamento di tutte le richieste e la coda è vuota. Questo parametro è facoltativo e può essere NULL.

Valore restituito

Nessuno

Osservazioni

Un driver deve assicurarsi che sia in corso solo uno dei metodi seguenti in un determinato momento:

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

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

Vedere anche

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop