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