ChangerClassInitialize-Funktion (mcd.h)
Die ChangerClassInitialize Routine initialisiert den Treiber.
Syntax
NTSTATUS ChangerClassInitialize(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPath,
PMCD_INIT_DATA ChangerInitData
);
Parameter
[in] DriverObject
Zeigen Sie auf das Changer-Miniklassentreiberobjekt. Dies wird als Parameter an die DriverEntry Routine des Miniklassentreibers übergeben. Das Format dieses Objekts ist betriebssystemspezifisch und sollte nicht vom Miniklassentreiber interpretiert werden.
[in] RegistryPath
Zeigen Sie auf den Registrierungspfad für Changer-Miniklassentreiber. Dies wird auch als Parameter an die DriverEntry Routine des Miniklassentreibers übergeben. Das Format dieses Betriebssystems ist spezifisch und sollte nicht vom Miniklassentreiber interpretiert werden.
ChangerInitData
Zeigen Sie auf eine MCD_INIT_DATA Struktur, die treiberspezifische Miniklasseninformationen enthält, z. B. die Einstiegspunkte für die Befehlsverarbeitungsroutinen der Changer-Miniklasse.
Rückgabewert
ChangerClassInitialize gibt einen Wert zurück, der den Erfolg oder Fehler der Treiberinitialisierung angibt. Wenn die Initialisierung erfolgreich ist, gibt ChangerClassInitialize STATUS_SUCCESS zurück. Andernfalls gibt ChangerClassInitialize eine entsprechende Fehlermeldung zurück. Minidriver sollten diesen Fehlerwert nicht interpretieren, sondern nur diesen Wert aus ihrer DriverEntry Routine zurückgeben.
Bemerkungen
ChangerClassInitialize ist eine Changerklassentreiberroutine, die Miniklassentreiber in Microsoft Windows XP und späteren Betriebssystemen aufrufen können.
Changer miniclass drivers call ChangerClassInitialize from within their DriverEntry routinen to initialize the driver. ChangerClassInitialize führt viele Aufgaben aus, die früher von der DriverEntry Routine des Changer-Klassentreibers durchgeführt wurden, z. B. das Registrieren der Dispatch-Routinen der Miniklasse. Sie weist eine Treiberobjekterweiterung zu und kopiert die Daten, die in MCDInitData enthalten sind, zusammen mit anderen Initialisierungsdaten wie dem Registrierungspfad des Treibers und Zeigern auf bestimmte Betriebssystemtreiberroutinen, die betriebssystemspezifisch sind.
Changer miniclass drivers must assign an MCD_INIT_DATA structure, zero the structure by calling RtlZeroMemory, and then assign values to the appropriate members, before passing the structure's address to ChangerClassInitialize by the MCDInitData parameter.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | mcd.h (include Mcd.h, Ntddchgr.h) |
| Library | Mcd.lib |