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
);
Parameter
[in] Driver
Ein Handle für das Frameworktreiberobjekt des Treibers, das durch einen vorherigen Aufruf von WdfDriverCreate oder WdfGetDriver abgerufen wurde.
Rückgabewert
WdfDriverGetRegistryPath gibt einen Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge zurück, die den Registrierungspfad des Treibers darstellt. Wenn das Treiberhandle ungültig ist, tritt eine Systemfehlerprüfung auf.
Hinweise
Die von WdfDriverGetRegistryPath zurückgegebene Registrierungspfadzeichenfolge wird aus der UNICODE_STRING-Struktur abgerufen, die der Treiber als Eingabe für seine DriverEntry-Routine empfangen 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 |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdriver.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |