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)

Vedi anche

WdfIoQueueStart

WdfIoQueueStop