WdfDriverGetRegistryPath-Funktion (wdfdriver.h)
[Gilt für KMDF und UMDF]
Die WdfDriverGetRegistryPath--Methode ruft den Pfad zum Registrierungsschlüssel des Treibers in der Services--Struktur der Registrierung ab.
Syntax
PWSTR WdfDriverGetRegistryPath(
[in] WDFDRIVER Driver
);
Die Parameter
[in] Driver
Ein Handle für das Framework-Treiberobjekt des Treibers, abgerufen durch einen vorherigen Aufruf von WdfDriverCreate oder WdfGetDriver-.
Rückgabewert
WdfDriverGetRegistryPath einen Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge zurück, die den Registrierungspfad des Treibers darstellt. Eine Systemfehlerüberprüfung tritt auf, wenn das Treiber- Handle ungültig ist.
Bemerkungen
Die Registrierungspfadzeichenfolge, die WdfDriverGetRegistryPath- zurückgibt, wird aus der UNICODE_STRING Struktur abgerufen, die der Treiber als Eingabe für die DriverEntry Routine erhalten hat.
Weitere Informationen zur Registrierung finden Sie unter Verwenden der Registrierung in Framework-Based Drivers.
Beispiele
Im folgenden Codebeispiel wird der Pfad zum Registrierungsschlüssel eines Treibers in der Services--Struktur der Registrierung abgerufen.
PWSTR registryPath;
registryPath = WdfDriverGetRegistryPath(driver);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfdriver.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |