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 info, vedi Introduzione con 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 garantire che solo uno dei metodi seguenti sia in corso in qualsiasi momento:

Ad esempio, se il driver precedentemente denominato 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.

Requisiti

   
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop