Metodo IWDFIoRequest2::Requeue (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.]

Il metodo requeue restituisce una richiesta di I/O all'inizio della coda di I/O da cui è stata recapitata al driver.

Sintassi

HRESULT Requeue();

Valore restituito

requeue restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
HRESULT_FROM_WIN32 (ERROR_INVALID_OPERATION)	Questo valore viene restituito se si verifica una delle condizioni seguenti: La richiesta di I/O specificata non proviene da una coda di I/O. Il driver non è proprietario della richiesta di I/O. La richiesta è annullabile. Il metodo di invio della coda non è manuale.

Questo metodo potrebbe restituire uno degli altri valori contenuti in Winerror.h.

Osservazioni

Un driver può chiamare Requeue solo se usa il metodo di invio manuale per la coda di I/O.

Esempi

L'esempio di codice seguente mostra un segmento di un IQueueCallbackStateChange::OnStateChange funzione di callback. Il segmento ottiene una richiesta di I/O dall'I/O e quindi restituisce la richiesta alla coda.

void 
CMyQueue::OnStateChange(
    __in IWDFIoQueue* pWdfQueue,
    __in WDF_IO_QUEUE_STATE 
    )
{
    HRESULT hr;
    IWDFIoRequest* Request;
...
    //
    // Get the IWDFIoRequest interface of the next request.
    //
    hr = pWdfQueue->RetrieveNextRequest(&Request);
...
    //
    // Declare an IWDFIoRequest2 interface pointer and obtain the
    // IWDFIoRequest2 interface from the IWDFIoRequest interface.
    //
    CComQIPtr<IWDFIoRequest2> r2 = Request;

    //
    // Add code here to determine whether to process or requeue the request.
    //
...
    //
    // Requeue the request.
    //
    hr = r2->Requeue();
    if (FAILED(hr)) goto Error;
...
}

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.9
intestazione	wudfddi.h (include Wudfddi.h)
dll	WUDFx.dll

Vedere anche

IWDFIoQueue::RetrieveNextRequest

IWDFIoRequest2

Condividi tramite