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)

Weitere Informationen

UNICODE_STRING

WdfDriverErstellen

WdfDriverOpenParametersRegistryKey

WdfGetDriver