Funzione WdfRequestRetrieveInputBuffer (wdfrequest.h)
[Si applica a KMDF e UMDF]
Il metodo WdfRequestRetrieveInputBuffer recupera il buffer di input di una richiesta di I/O.
Sintassi
NTSTATUS WdfRequestRetrieveInputBuffer(
[in] WDFREQUEST Request,
size_t MinimumRequiredLength,
[out] PVOID *Buffer,
[out, optional] size_t *Length
);
Parametri
[in] Request
Handle per un oggetto richiesta framework.
MinimumRequiredLength
Dimensioni minime del buffer, in byte, che il driver deve elaborare la richiesta di I/O.
[out] Buffer
Puntatore a una posizione che riceve l'indirizzo del buffer.
[out, optional] Length
Puntatore a una posizione che riceve le dimensioni del buffer, in byte. Questo parametro è facoltativo e può essere NULL.
Valore restituito
WdfRequestRetrieveInputBuffer 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. |
|
La lunghezza del buffer di input è zero o il parametro MinimumRequiredSize specifica una dimensione del buffer maggiore delle dimensioni effettive del buffer. |
|
Il tipo di richiesta non è valido o la richiesta usa né memorizzato nel buffer né nell'I/O diretto. Per altre informazioni sui metodi supportati per l'accesso ai buffer di dati, vedere la sezione Osservazioni seguente. |
|
La richiesta è già stata completata. |
|
Memoria insufficiente. |
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
Il buffer di input di una richiesta contiene informazioni, ad esempio i dati da scrivere in un disco, forniti dall'originatore della richiesta. Il driver può chiamare WdfRequestRetrieveInputBuffer per ottenere il buffer di input per una richiesta di scrittura o una richiesta di controllo I/O del dispositivo, ma non per una richiesta di lettura (perché le richieste di lettura non forniscono dati di input).
Il metodo WdfRequestRetrieveInputBuffer recupera il buffer di input per le richieste di I/O che usano il metodo di I/O memorizzato nel buffer o il metodo di I/O diretto per l'accesso ai buffer di dati. Se il codice di controllo di I/O della richiesta è IRP_MJ_INTERNAL_DEVICE_CONTROLo se la richiesta proviene da un altro driver in modalità kernel, WdfRequestRetrieveInputBuffer supporta anche le richieste di I/O che usano né memorizzate nel buffer néI/O diretto.
Se WdfRequestRetrieveInputBuffer restituisce STATUS_SUCCESS, il driver riceve l'indirizzo e, facoltativamente, le dimensioni del buffer di input.
Il driver può accedere al buffer recuperato fino a quando non completa la richiesta di I/O rappresentata dal parametro request.
Anziché chiamare WdfRequestRetrieveInputBuffer, il driver può chiamare WdfRequestRetrieveInputMemory, che crea un oggetto memoria framework che rappresenta il buffer.
Per altre informazioni su WdfRequestRetrieveInputBuffer, vedere Accesso ai buffer di dati in driver Framework-Based.
Esempi
L'esempio di codice seguente fa parte della seriale driver di esempio EvtIoDeviceControl funzione di callback. Se il codice di controllo di I/O è IOCTL_SERIAL_SET_TIMEOUT, il driver ottiene nuovi valori di timeout dal buffer di input della richiesta di I/O.
VOID
SerialEvtIoDeviceControl(
IN WDFQUEUE Queue,
IN WDFREQUEST Request,
IN size_t OutputBufferLength,
IN size_t InputBufferLength,
IN ULONG IoControlCode
)
{
PVOID buffer;
size_t bufSize;
switch (IoControlCode) {
...
case IOCTL_SERIAL_SET_TIMEOUTS: {
PSERIAL_TIMEOUTS NewTimeouts;
Status = WdfRequestRetrieveInputBuffer(
Request,
sizeof(SERIAL_TIMEOUTS),
&buffer,
&bufSize
);
if (!NT_SUCCESS(Status)) {
break;
}
NewTimeouts =(PSERIAL_TIMEOUTS)buffer;
}
...
}
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 | BufAfterReqCompletedIntIoctl(kmdf), BufAfterReqCompletedIntIoctlA(kmdf), BufAfterReqCompletedIoctl(km, BufAfterReqCompletedIoctlA(kmdf), BufAfterReqCompletedRead(kmdf), BufAfterReqCompletedWrite() kmdf), BufAfterReqCompletedWriteA(kmdf), DriverCreate(kmdf), InputBufferAPI(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |