Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[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 restituisce dopo che tutte le richieste non elaborate e di proprietà del driver (non incluse le richieste aggiunte alla coda dopo l'esecuzione della chiamata) vengono completate o annullate. Se vengono inserite nuove richieste durante WdfIoQueueStopAndPurgeSynchronously è in corso, queste nuove richieste non vengono recapitate finché il driver non 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 minima di KMDF | 1.11 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfio.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |