Funzione WdfRequestRequeue (wdfrequest.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

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

Sintassi

NTSTATUS WdfRequestRequeue(
  [in] WDFREQUEST Request
);

Parametri

[in] Request

Handle per un oggetto richiesta framework.

Valore restituito

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

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Un parametro di input non è valido.
STATUS_INVALID_DEVICE_REQUEST	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 può anche restituire altri valori NTSTATUS .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni

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

Se il driver chiama WdfRequestRequeue dopo aver chiamato WdfIoQueuePurge, il tentativo di accodamento potrebbe avere esito positivo prima del completamento dell'eliminazione. Nelle versioni 1.9 e precedenti di KMDF questa sequenza causa l'arresto anomalo del sistema operativo. Questo problema è stato risolto in KMDF versione 1.11 e successive.

Per altre informazioni su WdfRequestRequeue, vedere Requeuing I/O Requests.

Esempi

Nell'esempio di codice seguente viene restituita una richiesta di I/O specificata alla coda da cui il driver ha ricevuto la richiesta.

NTSTATUS status;

status = WdfRequestRequeue(request);

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfrequest.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite