EVT_WDF_IO_QUEUE_IO_DEFAULT funzione di callback (wdfio.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

La funzione di callback dell'evento EvtIoDefault di un driver elabora una richiesta di I/O specificata.

Sintassi

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

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.

Valore restituito

nessuno

Osservazioni

Un driver registra una funzione di callback EvtIoDefault 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 EvtIoDefault per la coda di I/O di un dispositivo, la funzione di callback riceve ogni richiesta di I/O dalla coda, a meno che non siano state registrate anche funzioni di callback specifiche della richiesta. Per altre informazioni sulle funzioni di callback specifiche della richiesta, vedere Gestori di richieste.

Anche la funzione di callback EvtIoDefault di un driver può ricevere richieste di creazione di file. Per altre informazioni sulla ricezione di richieste di creazione di file, vedere Oggetti file framework.

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

La maggior parte delle operazioni di I/O richiede un buffer di input, un buffer di output o entrambi. Per informazioni su come il driver può accedere ai buffer di una richiesta, 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 EvtIoDefault di un driver non deve chiamare i metodi dell'oggetto queue seguenti:

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously

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)