Funzione WdfIoQueueStopSynchronously (wdfio.h)
[Si applica a KMDF e UMDF]
Il metodo WdfIoQueueStopSynchronously impedisce a una coda di I/O di recapitare richieste di I/O, ma la coda riceve e archivia nuove richieste. Il metodo restituisce dopo che tutte le richieste recapitate sono state annullate o completate.
Sintassi
void WdfIoQueueStopSynchronously(
[in] WDFQUEUE Queue
);
Parametri
[in] Queue
Handle per un oggetto coda del framework.
Valore restituito
nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Il metodo WdfIoQueueStopSynchronously consente alla coda di ricevere nuove richieste, anche se la coda non riceveva nuove richieste prima che il driver chiama WdfIoQueueStopSynchronously. Ad esempio, un driver potrebbe chiamare WdfIoQueueDrain, che impedisce al framework di aggiungere nuove richieste di I/O alla coda. La chiamata successiva del driver di WdfIoQueueStopSynchronously fa sì che il framework riprenda ad aggiungere richieste alla coda.
Non chiamare WdfIoQueueStopSynchronously dalle funzioni di callback dell'evento dell'oggetto coda seguenti, indipendentemente dalla coda a cui è associata la funzione di callback dell'evento:
EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Per altre informazioni sul metodo WdfIoQueueStopSynchronously , vedere Gestione delle code di I/O.
Esempio
Nell'esempio di codice seguente viene arrestata una coda specificata.
WdfIoQueueStopSynchronously(WriteQueue);
Requisiti
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1,0 |
| 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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |