Metodo IQueueCallbackIoStop::OnIoStop (wudfddi.h)

Articolo
02/07/2025

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità 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, vedi Introduzione a UMDF.]

La OnIoStop funzione di callback interrompe l'elaborazione della richiesta di I/O specificata dalla coda specificata.

Sintassi

void OnIoStop(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ActionFlags
);

Parametri

[in] pWdfQueue

Puntatore all'interfaccia IWDFIoQueue per l'oggetto coda di I/O da cui viene interrotta l'elaborazione della richiesta di I/O.

[in] pWdfRequest

Puntatore all'interfaccia IWDFIoRequest che rappresenta l'oggetto richiesta framework di cui viene arrestata l'elaborazione.

[in] ActionFlags

Or bit per bit valido di WDF_REQUEST_STOP_ACTION_FLAGSvalori tipizzati che identificano lo stato di una richiesta di azione di arresto.

Valore restituito

Nessuno

Osservazioni

Un driver registra l'interfaccia IQueueCallbackIoStop quando il driver chiama il metodo IWDFDevice::CreateIoQueue per creare una coda di I/O o per configurare la coda di I/O predefinita.

Se un driver registra un OnIoStop funzione di callback per una coda di I/O, il framework lo chiama quando il dispositivo sottostante della coda lascia lo stato di lavoro (D0). Il framework chiama il OnIoStop funzione di callback per ogni richiesta di I/O che il driver non è stato completato, incluse le richieste di proprietà del driver e quelle inoltrate a una destinazione di I/O.

Il OnIoStop funzione di callback deve completare, annullare o posticipare un'ulteriore elaborazione della richiesta di I/O. È necessario usare le regole seguenti:

Se il driver possiede la richiesta di I/O, deve chiamare IWDFIoRequest::Complete per completare o annullare la richiesta oppure deve posticipare un'ulteriore elaborazione della richiesta e quindi chiamare IWDFIoRequest2::StopAcknowledge.

Se il driver ha inoltrato la richiesta di I/O a una destinazione di I/O, deve chiamare IWDFIoRequest::CancelSentRequest per tentare di annullare la richiesta oppure deve posticipare un'ulteriore elaborazione della richiesta e quindi chiamare StopAcknowledge.

Se il flag di WdfRequestStopRequestRequest È impostato nel parametro ActionFlags, Il driver deve chiamare IWDFIoRequest::UnmarkCancelable prima di chiamare IWDFIoRequest::Complete per completare (o annullare) la richiesta o chiamare IWDFIoRequest2::StopAcknowledge per rieseguere la richiesta.