Metodo IQueueCallbackWrite::OnWrite (wudfddi.h)

Articolo
03/05/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità 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 info, vedi Introduzione con UMDF.]

Il metodo OnWrite viene chiamato per gestire una richiesta di scrittura quando un'applicazione scrive informazioni in un dispositivo tramite la funzione WriteFile o WriteFileEx di Microsoft Win32.

Sintassi

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

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] NumOfBytesToWrite

Dimensione, in byte, del buffer di scrittura per la richiesta.

Valore restituito

nessuno

Osservazioni

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

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

Il metodo OnWrite riceve ogni tipo di richiesta di scrittura dalla coda. Il tipo di richiesta di scrittura è identificato dal valore WdfRequestWrite del tipo di enumerazione WDF_REQUEST_TYPE per la richiesta. Il metodo OnWrite deve elaborare ogni richiesta di scrittura 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::GetWriteParameters e IWDFIoRequest::GetInputMemory per recuperare informazioni sulla richiesta e sul buffer di scrittura.