RequestCompleted-Regel (kmdf)

Die RequestCompleted-Regel gibt an, dass für einen Nicht-Filtertreiber jede Anforderung, die der Standard-E/A-Warteschlange des Treibers angezeigt wird, abgeschlossen werden muss, es sei denn, die Anforderung wird verzögert oder weitergeleitet, oder wenn WdfRequestStopAcknowledge aufgerufen wird.

Eine E/A-Anforderung, die der Standardwarteschlange des Treibers über eine der Warteschlangenrückruffunktionen angezeigt wird, muss abgeschlossen werden, bevor sie aus den E/A-Anforderungsrückruffunktionen beendet wird, außer in den folgenden Fällen:

• Die Anforderung wurde zurückgestellt (z. B. auf einen DPC oder ein Arbeitselement). In diesem Fall können Sie die DeferredRequestCompleted-Regel verwenden.

• Die Anforderung wurde an ein E/A-Ziel oder eine andere Warteschlange weitergeleitet.

• Die Anforderung wurde an das Framework übermittelt (durch Aufrufen von WdfDeviceEnqueueRequest).

• WdfRequestStopAcknowledge wurde aufgerufen.

Die Regel wird überprüft, wenn der Treiber die folgenden Rückruffunktionen verlässt:

• EvtIoStop, EvtCleanupCallback oder EvtDestroyCallback für die Warteschlange

• EvtCleanupCallback oder EvtDestroyCallback für das Dateiobjekt

• EvtFileClose, EvtFileCleanup, EvtDeviceSelfManagedIoSuspend, EvtDeviceSelfManagedIoFlush, EvtDeviceSelfManagedIoCleanup, EvtDeviceShutdownNotification, EvtDeviceSurpriseRemoval, EvtCleanupCallback oder EvtDestroyCallback für das Gerät

• EvtDriverUnload

Die E/A-Warteschlangenrückruffunktionen für die Anforderungspräsentation sind EvtIoDefault, EvtIoRead, EvtIoWrite, EvtIoDeviceControl und EvtIoInternalDeviceControl

Treibermodell: KMDF

So führen Sie einen Test durch

Beim Kompilieren:

Führen Sie Static Driver Verifier aus, und geben Sie die Regel RequestCompleted an . Gehen Sie folgendermaßen vor, um Ihren Code zu analysieren: Bereiten Sie den Code vor (verwenden Sie Rollentypdeklarationen). Führen Sie Static Driver Verifier aus. Überprüfen und analysieren Sie die Ergebnisse. Weitere Informationen finden Sie unter Verwenden der statischen Treiberüberprüfung, um Fehler in Treibern zu finden.

Gilt für:

WdfDeviceEnqueueRequestWdfDmaTransactionInitializeWdfDmaTransactionInitializeUsingRequestWdfIoTargetSendInternalIoctlOthersSynchronlyWdfIoTargetSendInternalIoctlSynchronouslyWdfIoTargetSendIoctlSynchronouslyWdfIoTargetSendReadSynchronouslyWdfIoTargetSendWriteSynchronouslyWdfRequestCompleteWdfRequestCompleteWithInformationWdfRequestCompleteWithPriorityBoostWdfRequestForwardToIoQueueWdfRequestMarkCancelableWdfRequestMarkCancelableExWdfRequestSendWdfRequestStopAcknowledgeWdfWorkItemEnqueue