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 viene restituito dopo il completamento o l'annullamento di tutte le richieste non elaborate e di proprietà del driver (non incluse le richieste aggiunte alla coda dopo l'esecuzione di questa chiamata). Se vengono inserite nuove richieste mentre WdfIoQueueStopAndPurgeSynchronously è in corso, queste nuove richieste non vengono recapitate finché il driver 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 KMDF minima 1.11
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), NoCancelFromEvtSurpriseRemove(kmdf)

Vedi anche

WdfIoQueueStopAndPurge