Funzione WdfRequestProbeAndLockUserBufferForWrite (wdfrequest.h)
[Si applica solo a KMDF]
Il metodo WdfRequestProbeAndLockUserBufferForWrite verifica che il buffer in modalità utente di una richiesta di I/O sia scrivibile e quindi blocca le pagine di memoria fisica del buffer in modo che i driver nello stack di driver possano scrivere nel buffer.
Sintassi
NTSTATUS WdfRequestProbeAndLockUserBufferForWrite(
[in] WDFREQUEST Request,
[in] PVOID Buffer,
[in] size_t Length,
[out] WDFMEMORY *MemoryObject
);
Parametri
[in] Request
Handle per un oggetto richiesta del framework.
[in] Buffer
Puntatore al buffer di output della richiesta. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
[in] Length
Lunghezza, in byte, del buffer di output della richiesta.
[out] MemoryObject
Puntatore a una posizione che riceve un handle a un oggetto memoria del framework che rappresenta il buffer di output dell'utente.
Valore restituito
WdfRequestProbeAndLockUserBufferForWrite 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. |
|
Il parametro Length è zero. |
|
La richiesta è già stata completata o non è valida. |
|
Il thread corrente non è l'autore della richiesta di I/O. |
|
Memoria insufficiente per completare l'operazione. |
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
Il buffer di output dell'utente riceve in genere informazioni che il driver ha letto dal dispositivo.
Solo un driver di primo livello può chiamare il metodo WdfRequestProbeAndLockUserBufferForWrite , perché il metodo richiede il contesto del processo che ha creato la richiesta di I/O.
Il buffer in modalità utente specificato dal parametro Buffer può essere il buffer recuperato da WdfRequestRetrieveUnsafeUserOutputBuffer oppure può essere un buffer di output in modalità utente diverso. Ad esempio, un codice di controllo di I/O che usa il metodo di accesso memorizzato nel buffer potrebbe passare una struttura che contiene un puntatore incorporato a un buffer in modalità utente. In tal caso, il driver può usareWdfRequestProbeAndLockUserBufferForWrite per ottenere un oggetto memoria per il buffer.
La lunghezza del buffer specificata dal parametro Length non deve essere maggiore delle dimensioni effettive del buffer. In caso contrario, i driver possono accedere alla memoria all'esterno del buffer, che rappresenta un rischio per la sicurezza.
Se WdfRequestProbeAndLockUserBufferForWrite restituisce STATUS_SUCCESS, il driver riceve un handle per un oggetto memoria framework che rappresenta il buffer in modalità utente. Per accedere al buffer, il driver deve chiamare WdfMemoryGetBuffer.
L'oggetto memoria del framework viene rilasciato automaticamente quando il driver chiama WdfRequestComplete.
Per altre informazioni su WdfRequestProbeAndLockUserBufferForWrite, vedere Accesso ai buffer di dati nei driver Framework-Based.
Esempio
Per un esempio di codice che usa WdfRequestProbeAndLockUserBufferForWrite, vedere WdfRequestProbeAndLockUserBufferForRead.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfrequest.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |