Funzione WdfRequestRequeue (wdfrequest.h)
[Si applica a KMDF e UMDF]
Il metodo WdfRequestRequeue restituisce una richiesta di I/O all'intestazione 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 del 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 |
---|---|
|
Un parametro di input non è valido. |
|
Questo valore viene restituito se si verifica una delle condizioni seguenti:
|
Questo metodo potrebbe anche restituire altri valori NTSTATUS.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Commenti
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 .For more information about WdfRequestRequeue, see Requeuing I/O Requests.
Esempio
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);
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Versione KMDF minima | 1.0 |
Versione UMDF minima | 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) |