Riutilizzo degli oggetti del framework di richiesta in UMDF

Avvertimento

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.

Gli esempi di UMDF 1 archiviati sono disponibili nell'aggiornamento degli esempi di driver di Windows 11, versione 22H2 - maggio 2022.

Per altre informazioni, vedere Introduzione a UMDF.

Per migliorare le prestazioni del driver, i driver basati su framework che creano e inviano molte richieste asincrone quasi identiche a una destinazione di I/O possono riutilizzare gli oggetti richiesta anziché creare un nuovo oggetto richiesta per ogni richiesta. Un driver può riutilizzare un oggetto richiesta dopo il completamento della richiesta.

Se un driver ha creato un oggetto richiesta chiamando IWDFDevice::CreateRequest, può riutilizzare la richiesta chiamando IWDFIoRequest2::Reuse. Un driver può anche riutilizzare gli oggetti richiesta ricevuti dal framework nelle code di I/O.

Se il driver fornisce una funzione di callback IRequestCallbackRequestCompletion::OnCompletion per un oggetto di richiesta che viene riutilizzato, il driver deve chiamare IWDFIoRequest::SetCompletionCallback dopo aver chiamato Reuse.