Funzione WdfIoQueueStopAndPurgeSynchronously (wdfio.h)
[Si applica a KMDF e UMDF]
Il metodo WdfIoQueueStopAndPurgeSynchronously impedisce a una coda di I/O di recapitare nuove richieste di I/O e fa sì che il framework annulla le richieste non elaborate esistenti e le richieste annullabili di proprietà del driver, ma la coda riceve e archivia nuove richieste.
Sintassi
void WdfIoQueueStopAndPurgeSynchronously(
[in] WDFQUEUE Queue
);
Parametri
[in] Queue
Handle per un oggetto coda del framework.
Valore restituito
nessuno
Osservazioni
Questo metodo viene restituito dopo il completamento o l'annullamento di tutte le richieste non elaborate e di proprietà del driver (non incluse le richieste aggiunte alla coda dopo l'esecuzione di questa chiamata). Se vengono inserite nuove richieste mentre WdfIoQueueStopAndPurgeSynchronously è in corso, queste nuove richieste non vengono recapitate finché il driver chiama WdfIoQueueStart.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Versione KMDF minima | 1.11 |
Versione UMDF minima | 2,0 |
Intestazione | wdfio.h (include Wdf.h) |
Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | PASSIVE_LEVEL |
Regole di conformità DDI | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |