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
Zeiger 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
Zeiger auf den Registrierungspfad für changer miniclass driver. Dies wird auch als Parameter an die DriverEntry-Routine des Miniklassentreibers übergeben. Das Format ist betriebssystemspezifisch und sollte nicht vom Miniklassentreiber interpretiert werden.
ChangerInitData
Zeiger auf eine MCD_INIT_DATA-Struktur , die treiberspezifische Informationen für Miniklassen enthält, z. B. die Einstiegspunkte für die Befehlsverarbeitungsroutinen des Changer-Miniklassentreibers.
Rückgabewert
ChangerClassInitialize gibt einen Wert zurück, der den Erfolg oder Fehler der Treiberinitialisierung angibt. Wenn die Initialisierung erfolgreich war, 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.
Hinweise
ChangerClassInitialize ist eine Changer-Klassentreiberroutine, die Miniklassentreiber in Microsoft Windows XP und höheren Betriebssystemen aufrufen können.
Changer-Miniklassentreiber rufen ChangerClassInitialize innerhalb ihrer DriverEntry-Routinen auf, um den Treiber zu initialisieren. ChangerClassInitialize führt viele Aufgaben aus, die zuvor von der DriverEntry-Routine des Wechselklassentreibers ausgeführt wurden, z. B. das Registrieren der Dispatchroutinen des Miniklassentreibers. Es ordnet eine Treiberobjekterweiterung zu und kopiert die in MCDInitData enthaltenen Daten in die Treiberobjekterweiterung zusammen mit anderen Initialisierungsdaten, z. B. dem Registrierungspfad des Treibers und Zeigern auf bestimmte betriebssystemspezifische Changerklassentreiberroutinen.
Changer-Miniklassentreiber müssen eine MCD_INIT_DATA Struktur zuordnen, die Struktur durch Aufrufen von RtlZeroMemory null und dann den entsprechenden Membern Werte zuweisen, bevor die Adresse der Struktur mithilfe des MCDInitData-Parameters an ChangerClassInitialize übergeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | mcd.h (include Mcd.h, Ntddchgr.h) |
| Bibliothek | Mcd.lib |