Metodo IQueueCallbackWrite::OnWrite (wudfddi.h)

Articolo
02/07/2025

[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 informazioni, vedi Introduzione a UMDF.]

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

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 framework.

[in] NumOfBytesToWrite

Dimensioni, 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 di OnWrite per tutte le code di I/O o per tutti i metodi di OnWrite 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 di WdfRequestWrite del tipo di enumerazione WDF_REQUEST_TYPE per la richiesta. Il metodo OnWrite deve elaborare ogni richiesta di scrittura ricevuta. Per altre informazioni sul modo in cui i driver UMDF elaborano le richieste di I/O, vedere l'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.