DRIVER_INITIALIZE Rückruffunktion (wdm.h)
DriverEntry ist die erste Routine, die nach dem Laden eines Treibers aufgerufen wird, und ist für die Initialisierung des Treibers verantwortlich.
Syntax
DRIVER_INITIALIZE DriverInitialize;
NTSTATUS DriverInitialize(
[in] _DRIVER_OBJECT *DriverObject,
[in] PUNICODE_STRING RegistryPath
)
{...}
Parameter
[in] DriverObject
Ein Zeiger auf eine DRIVER_OBJECT-Struktur . Dies ist das Treiberobjekt des Treibers.
[in] RegistryPath
Ein Zeiger auf eine gezählte Unicode-Zeichenfolge, die den Pfad zum Registrierungsschlüssel des Treibers angibt.
Rückgabewert
Wenn die Routine erfolgreich ist, muss sie STATUS_SUCCESS zurückgeben. Andernfalls muss einer der In Ntstatus.h definierten Fehlerwerte status zurückgegeben werden.
Hinweise
Der DriverObject-Parameter stellt der DriverEntry-Routine einen Zeiger auf das Treiberobjekt des Treibers bereit, das vom E/A-Manager zugeordnet wird. Die DriverEntry-Routine muss das Driver-Objekt mit Einstiegspunkten für die Standardroutinen des Treibers ausfüllen.
Der DriverObject-Zeiger gewährt dem Treiber Zugriff auf DriverObject-HardwareDatabase>, die auf eine gezählte Unicode-Zeichenfolge verweist, die einen Pfad zur \Registry\Machine\Hardware-Struktur der Registrierung angibt.
Die Registrierungspfadzeichenfolge, auf die von RegistryPath verwiesen wird, hat das Format \Registry\Machine\System\CurrentControlSet\Services\DriverName. Ein Treiber kann diesen Pfad verwenden, um treiberspezifische Informationen zu speichern. Siehe Registrierungsschlüssel für Treiber. Die DriverEntry-Routine sollte eine Kopie der Unicode-Zeichenfolge speichern, nicht den Zeiger, da der E/ A-Manager den RegistryPath-Puffer nach der Rückgabe von DriverEntry freigibt.
Weitere Informationen zum Implementieren einer DriverEntry-Routine finden Sie unter Schreiben einer DriverEntry-Routine.
Obwohl es möglich ist, diese Routine etwas anderes als DriverEntry zu nennen, wird dies nicht empfohlen. Die von DDK bereitgestellten Buildtools informieren den Linker automatisch darüber, dass der Einstiegspunkt des Treibers DriverEntry heißt. Wenn Sie der Routine einen anderen Namen geben, müssen Sie die Buildtools ändern. Weitere Informationen zu Buildtools finden Sie unter Erstellen eines Treibers.
Beispiele
Um eine DriverEntry-Rückrufroutine zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten Rückrufroutine angibt. Windows bietet eine Reihe von Rückruffunktionstypen für Treiber. Das Deklarieren einer Funktion mithilfe der Rückruffunktionstypen hilft der Codeanalyse für Treiber, der statischen Treiberüberprüfung (Static Driver Verifier , SDV) und anderen Überprüfungstools, Fehler zu finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.
Um eine DriverEntry-Rückrufroutine zu definieren, verwenden Sie den DRIVER_INITIALIZE-Typ, wie in diesem Codebeispiel gezeigt:
DRIVER_INITIALIZE DriverEntry;
Implementieren Sie dann Ihre Rückrufroutine wie folgt:
_Use_decl_annotations_
NTSTATUS
DriverEntry(
struct _DRIVER_OBJECT *DriverObject,
PUNICODE_STRING RegistryPath
)
{
// Function body
}
Der DRIVER_INITIALIZE Funktionstyp ist in der Wdm.h-Headerdatei definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, fügen Sie die _Use_decl_annotations_ Anmerkung ihrer Funktionsdefinition hinzu. Die _Use_decl_annotations_ Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den DRIVER_INITIALIZE Funktionstyp in der Headerdatei angewendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für WDM-Treiber. Informationen zu _Use_decl_annotations_finden Sie unter Annotating Function Behavior.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (include Mcd.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| IRQL | Wird bei PASSIVE_LEVEL aufgerufen. |