Återanvända ramverksbegärandeobjekt

För att förbättra prestanda kan ramverksbaserade drivrutiner som skapar och skickar många nästan identiska asynkrona begäranden till ett I/O-mål återanvända begärandeobjekt i stället för att skapa ett nytt begärandeobjekt för varje begäran. En drivrutin kan återanvända ett begärandeobjekt när begäran har slutförts.

Om en drivrutin har skapat en begäran genom att anropa WdfRequestCreate eller WdfRequestCreateFromIrp, kan den återanvändas genom att anropa WdfRequestReuse. En drivrutin kan också återanvända begärandeobjekt som den har tagit emot från ramverket i sina I/O-köer, men den kan inte ändra den IRP som det mottagna begärandeobjektet innehåller.

Om du är noga med att undvika situationer som orsakar de misslyckade returvärden som beskrivs i WdfRequestReuse, kan drivrutinen anropa WdfRequestReuse från inom en CompletionRoutine återanropsfunktion. (Funktionen CompletionRoutine för återuppringning har ett VOID-returvärde och kan därför inte rapportera fel.)

Om drivrutinen tillhandahåller en CompletionRoutine motsvarandefunktion för en begäran som återanvänds måste drivrutinen anropa WdfRequestSetCompletionRoutine efter att ha anropat WdfRequestReuse.