Metodo IQueueCallbackRead::OnRead (wudfddi.h)

Articolo
08/08/2023

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo OnRead viene chiamato per gestire una richiesta di lettura quando un'applicazione legge le informazioni da un dispositivo tramite la funzione Microsoft Win32 ReadFile o ReadFileEx.

Sintassi

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

Parametri

[in] pWdfQueue

Puntatore all'interfaccia IWDFIoQueue per l'oggetto coda di I/O da cui arriva la richiesta.

[in] pWdfRequest

Puntatore all'interfaccia IWDFIoRequest che rappresenta l'oggetto richiesta del framework.

[in] NumOfBytesToRead

Dimensioni, in byte, del buffer di lettura per la richiesta.

Valore restituito

nessuno

Osservazioni

Un driver registra l'interfaccia IQueueCallbackRead quando il driver chiama il metodo IWDFDevice::CreateIoQueue per creare una coda I/O o per configurare la coda I/O predefinita.

Un driver può implementare un singolo metodo OnRead per tutte le code di I/O o o i metodi OnRead separati per ogni coda di I/O.

Il metodo OnRead riceve ogni tipo di richiesta di lettura dalla coda. Il tipo di richiesta di lettura viene identificato dal valore WdfRequestRead del tipo di enumerazione WDF_REQUEST_TYPE per la richiesta. Il metodo OnRead deve elaborare ogni richiesta di lettura ricevuta. Per altre informazioni su come i driver UMDF elaborano le richieste di I/O, vedere Elaborazione delle richieste di I/O.

Il driver può chiamare i metodi IWDFIoRequest::GetReadParameters e IWDFIoRequest::GetOutputMemory per recuperare informazioni sulla richiesta e sul buffer di lettura.