EVT_WDF_IO_QUEUE_IO_READ funzione di callback (wdfio.h)

  • Articolo

[Si applica a KMDF e UMDF]

La funzione di callback dell'evento EvtIoRead di un driver elabora una richiesta di lettura specificata.

Sintassi

EVT_WDF_IO_QUEUE_IO_READ EvtWdfIoQueueIoRead;

void EvtWdfIoQueueIoRead(
  [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 framework.

[in] Length

Numero di byte da leggere.

Valore restituito

nessuno

Osservazioni

Un driver registra una funzione di callback EvtIoRead 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 EvtIoRead per la coda I/O di un dispositivo, la funzione di callback riceve ogni richiesta di lettura dalla coda. Per altre informazioni, vedere Gestori richieste.

La funzione di callback EvtIoRead deve elaborare ogni richiesta di I/O ricevuta in qualche modo. Per altre informazioni, vedere Elaborazione delle richieste di I/O.

Le richieste di lettura richiedono un buffer di output, che riceve i dati forniti dal driver. Per informazioni su come il driver può accedere al buffer di una richiesta di lettura, 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 delle richieste, vedere Uso della sincronizzazione automatica.

La funzione di callback EvtIoRead di un driver non deve chiamare i metodi dell'oggetto coda seguenti:

WdfIoQueueDrainSynchronously
WdfIoQueuePurgeSynchronously
WdfIoQueueStopSynchronously

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfio.h (includere Wdf.h)
IRQL <= DISPATCH_LEVEL (vedere sezione Osservazioni)

Vedi anche

EvtIoDefault

EvtIoWrite

WDF_OBJECT_ATTRIBUTES

WdfIoQueueCreate