EVT_WDF_IO_QUEUE_IO_WRITE funzione di callback (wdfio.h)
[Si applica a KMDF e UMDF]
La funzione di callback dell'evento EvtIoWrite di un driver elabora una richiesta di scrittura specificata.
Sintassi
EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;
void EvtWdfIoQueueIoWrite(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
Parametri
[in] Queue
Handle per l'oggetto coda del framework associato alla richiesta di I/O.
[in] Request
Handle per un oggetto richiesta del framework.
[in] Length
Numero di byte da scrivere.
Valore restituito
nessuno
Osservazioni
Un driver registra una funzione di callback EvtIoWrite quando chiama WdfIoQueueCreate. Per altre informazioni sulla chiamata a WdfIoQueueCreate, vedere Creazione di code di I/O.
Se un driver ha registrato una funzione di callback EvtIoWrite per la coda di I/O di un dispositivo, la funzione di callback riceve ogni richiesta di scrittura dalla coda. Per altre informazioni, vedere Gestori di richieste.
La funzione di callback EvtIoWrite deve elaborare ogni richiesta di I/O ricevuta in qualche modo. Per altre informazioni, vedere Elaborazione delle richieste di I/O.
Le richieste di scrittura richiedono un buffer di input, che contiene i dati ricevuti dal driver. Per informazioni su come il driver può accedere al buffer di una richiesta di scrittura, vedere Accesso ai buffer dei dati in Framework-Based Driver.
Questa funzione di callback può essere chiamata in IRQL <= DISPATCH_LEVEL, a meno che il membro ExecutionLevel della struttura di WDF_OBJECT_ATTRIBUTES del dispositivo o del driver sia impostato su WdfExecutionLevelPassive.
Se IRQL è PASSIVE_LEVEL, il framework chiama la funzione di callback all'interno di un'area critica.
Per altre informazioni sui livelli IRQL per i gestori di richieste, vedere Uso della sincronizzazione automatica.
La funzione di callback EvtIoWrite di un driver non deve chiamare i metodi dell'oggetto coda seguenti:
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfio.h (include Wdf.h) |
| IRQL | <= DISPATCH_LEVEL (vedere la sezione Osservazioni) |