Funzione WdfIoQueueStopSynchronously (wdfio.h)

  • Articolo

[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 a un oggetto code del framework.

Valore restituito

nessuno

Osservazioni

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Il metodo WdfIoQueueStopSynchronously consente alla coda di ricevere nuove richieste, anche se la coda non riceveva nuove richieste prima del driver denominato WdfIoQueueStopSynchronously. Ad esempio, un driver potrebbe chiamare WdfIoQueueDrain, che causa l'interruzione dell'aggiunta di nuove richieste di I/O alla coda. La chiamata successiva del driver di WdfIoQueueStopSynchronously causa al framework di riprendere l'aggiunta di richieste alla coda.

Non chiamare WdfIoQueueStopSynchronously dalle funzioni di callback dell'evento dell'evento di coda seguenti, indipendentemente dalla coda con cui è associata la funzione di callback dell'evento:

EvtIoDefaultEvtIoDeviceControl EvtIoInternalDeviceControl EvtIoRead EvtIoWrite Per altre informazioni sul metodo WdfIoQueueStopSynchronously, vedere Gestione delle code di I/O.

Esempio

L'esempio di codice seguente arresta una coda specificata.

WdfIoQueueStopSynchronously(WriteQueue);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfio.h (includere 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