Deklarationen der KMDF-Funktion für statische Treiberüberprüfung

Um SDV zum Überprüfen des KMDF-Treibers zu aktivieren, müssen Sie jede Rückruffunktion mithilfe eines Rollentyps der Rückruffunktion deklarieren. Die Rollentypen der Rückruffunktion werden in den verschiedenen WDF-Headerdateien definiert und sind enthalten, wenn Sie ihren Treiber mit der Wdf.h-Headerdatei erstellen. In der folgenden Tabelle sind die Funktionsrollentypen und die Ereignisrückruffunktionen aufgeführt, denen sie zugeordnet sind.

Sie müssen die Treiberrückruffunktionen vor den Definitionen der Rückruffunktionen deklarieren. Das folgende Beispiel zeigt die Funktionsrollentypdeklaration für die Rückruffunktion EvtDriverDeviceAdd . In diesem Beispiel wird die Rückruffunktion "EvtDriverDeviceAdd" genannt.

#include <NTDDK.h>  
#include <wdf.h>
EVT_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd

Wenn eine Rückruffunktion über eine Funktionsprototypdeklaration verfügt, müssen Sie den Funktionsprototyp durch die Funktionsrollentypdeklaration ersetzen. Weitere Informationen zu den Funktionsrollentypdeklarationen finden Sie unter Verwenden von Funktionsrollentypdeklarationen.

In der folgenden Tabelle sind die Rückruffunktionstypen und die Ereignisrückruffunktionen aufgeführt, denen sie zugeordnet sind.

Funktionsrollentypen, die mehrere Rückruffunktionen zulassen

Es gibt einige Funktionsrollentypen, die mehrere Ereignisrückruffunktionen zugeordnet sein können. Beispielsweise kann ein Treiber mehrere EvtTimerFunc - oder EvtDpcFunc-Rückruffunktionen aufweisen. Die folgende Tabelle zeigt die maximale Anzahl von Rückrufen, die SDV für jeden Funktionsrollentyp unterstützt. Obwohl es für einen Treiber nicht falsch ist, mehr als die maximale Anzahl der in der Tabelle aufgeführten Rückruffunktionen zu haben, wird der Überprüfungsprozess bei Verwendung von SDV erschwert. Informationen zu Änderungen, die Sie möglicherweise an der Datei Sdv-map.h vornehmen müssen, um die zusätzlichen Rückruffunktionen aufzunehmen, finden Sie unter "Doppelte Einstiegspunkte für einen Funktionsrollentyp".

Funktionsrollentypen und E/A-Warteschlangen

Verwenden Sie die folgenden Funktionsrollentypen, wenn Sie die Anforderungshandler und Rückruffunktionen deklarieren, die auf dem KMDF-Framework basieren, um die E/A-Anforderungen an den Treiber zu übermitteln (für sequenzielle oder parallele Verteiler). Verwenden Sie diese Funktionsrollentypen nicht für die Funktionen, die Anforderungen manuell von der Standardwarteschlange an andere Warteschlangen weiterleiten (manuelle Verteilerfunktion). SDV unterstützt kein Speichermodell, mit dem Anforderungen von einer Warteschlange auf eine andere nachverfolgt werden können.

Weitere Informationen zu E/A-Warteschlangen finden Sie unter Erstellen von E/A-Warteschlangen.

Funktionsrollentypen für die Funktionen EvtCleanupCallback und EvtDestroyCallback

Sie müssen die Funktion EvtCleanupCallback und EvtDestroyCallback mit objektspezifischen Funktionsrollentypen deklarieren. SDV erfordert diese objektspezifischen Rollentypen, um festzustellen, ob der Treiber ordnungsgemäß die Rückruffunktion verwendet. Verwenden Sie die folgenden Tabellen, um zu bestimmen, welcher Funktionstyp verwendet werden soll.