Condividi tramite

Metodo IWDFIoQueue::Stop (wudfddi.h)

  • Articolo

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo Stop impedisce a una coda di I/O di recapitare richieste di I/O, ma la coda riceve e archivia nuove richieste.

Sintassi

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

Parametri

[in, optional] pStopComplete

Puntatore all'interfaccia IQueueCallbackStateChange il cui metodo chiama il framework dopo tutte le richieste di I/O in sospeso, se presente, nel driver. Questo parametro è facoltativo e può essere NULL.

Valore restituito

nessuno

Osservazioni

Una chiamata a Stop è asincrona e restituisce immediatamente al driver. Il driver viene notificato tramite il metodo dell'interfaccia IQueueCallbackStateChange fornita dopo il completamento di tutte le richieste in sospeso nel driver.

Il driver deve assicurarsi che solo uno dei metodi seguenti sia in corso in qualsiasi momento:

Ad esempio, se il driver precedentemente denominato Stop, deve attendere la notifica dal metodo dell'interfaccia a cui punta il parametro pStopComplete prima che il driver chiami Drain o Purge. La violazione di questa regola comporta la chiusura del processo host.

Il metodo Stop consente alla coda di ricevere nuove richieste, anche se la coda non riceveva nuove richieste prima del driver denominato Stop. Ad esempio, un driver potrebbe chiamare IWDFIoQueue::D rain, che causa l'interruzione dell'aggiunta di nuove richieste di I/O alla coda. La chiamata successiva del driver di Stop causa la ripresa del framework per l'aggiunta di richieste alla coda.

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge