Riutilizzo degli oggetti di richiesta del framework

Per migliorare le prestazioni, 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 WdfRequestCreate o WdfRequestCreateFromIrp, può riutilizzare la richiesta chiamando WdfRequestReuse. Un driver può anche riutilizzare gli oggetti di richiesta ricevuti dal framework nelle code di I/O, ma non può modificare l'IRP contenuto nell'oggetto di richiesta ricevuto.

Se si è attenti a evitare situazioni che causano valori di ritorno non riusciti come descritto in WdfRequestReuse, il driver può chiamare WdfRequestReuse dall'interno di una funzione di callback CompletionRoutine. La CompletionRoutine funzione di callback ha un valore di ritorno VOID e pertanto non può segnalare errori.

Se il driver fornisce una funzione di callback CompletionRoutine per un oggetto di richiesta riutilizzato, il driver deve chiamare WdfRequestSetCompletionRoutine dopo aver chiamato WdfRequestReuse.