Riutilizzo degli oggetti richiesta framework in UMDF

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.

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

Per altre informazioni, vedere Introduzione con UMDF.

Per migliorare le prestazioni dei 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 invece di 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 request chiamando IWDFDevice::CreateRequest, può riutilizzare la richiesta chiamando IWDFIoRequest2::Rius. Un driver può anche riutilizzare gli oggetti di richiesta ricevuti dal framework nelle code di I/O.

Se il driver fornisce una funzione di callback IRequestCallbackRequestCompletion::OnCompletion callback per un oggetto request riutilizzato, il driver deve chiamare IWDFIoRequest::SetCompletionCallback dopo la chiamata al riutilizzo.