Condividi tramite


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 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)

Vedere anche

WdfIoQueueStopAndPurge