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 chiamasse 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 con cui è associata la funzione di callback dell'evento:

EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Per altre informazioni sul metodo WdfIoQueueStopSynchronously, vedere Managing I/O Queues.

Esempi

Nell'esempio di codice seguente viene arrestata una coda specificata.

WdfIoQueueStopSynchronously(WriteQueue);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

Vedere anche

WdfIoQueueStart

WdfIoQueueStop