Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt für KMDF und UMDF]
Die WdfDeviceOpenDevicemapKey Methode öffnet den DEVICEMAP- Schlüssel und erstellt ein Framework-Registrierungsschlüsselobjekt, das den Registrierungsschlüssel darstellt.
Syntax
NTSTATUS WdfDeviceOpenDevicemapKey(
[in] WDFDEVICE Device,
[in] PCUNICODE_STRING KeyName,
[in] ACCESS_MASK DesiredAccess,
[in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
[out] WDFKEY *Key
);
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
[in] KeyName
Ein Zeiger auf eine UNICODE_STRING Struktur, die den Namen des Unterschlüssels angibt, der unter DEVICEMAP-geöffnet werden soll.
[in] DesiredAccess
Ein ACCESS_MASK-typed-Wert, der Zugriffsrechte angibt, die der Treiber für den angegebenen Registrierungsschlüssel anfordert.
Ein KMDF-Treiber fordert in der Regel KEY_READ, KEY_WRITEoder KEY_READ | KEY_WRITE.
Ein UMDF-Treiber fordert in der Regel KEY_READ oder KEY_SET_VALUEan.
[in, optional] KeyAttributes
Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES-Struktur, die vom Treiber bereitgestellte Attribute für das neue Registrierungsschlüsselobjekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
[out] Key
Ein Zeiger auf einen Speicherort, der ein Handle für das neue Registrierungsschlüsselobjekt empfängt. Das
Rückgabewert
WdfDeviceOpenDevicemapKey gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
WdfDeviceOpenDevicemapKey wurde bei IRQL = PASSIVE_LEVEL nicht aufgerufen. |
|
Es wurde ein ungültiger Parameter angegeben. Bei UMDF kann dieser Rückgabewert auf unzureichende Zugriffsrechte hinweisen. |
|
Ein Registrierungsschlüsselobjekt konnte nicht zugeordnet werden. |
|
Der angegebene Registrierungsschlüssel ist nicht vorhanden. |
Eine Liste mit anderen Rückgabewerten, die von der WdfDeviceOpenDevicemapKey--Methode zurückgegeben werden können, finden Sie unter Framework Object Creation Errors.
Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Die Registrierung enthält einen HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP Schlüssel, den einige Treiber für ältere Technologien, z. B. serielle und parallele Ports, verwenden. Wenn Ihr Treiber eine Technologie unterstützt, die den DEVICEMAP--Schlüssel verwendet, kann der Treiber auf Unterschlüssel und Werte unter dem Schlüssel zugreifen, indem er WdfDeviceOpenDevicemapKeyaufruft.
WdfDeviceOpenDevicemapKey gibt eine veränderliche Key-zurück. Dies bedeutet, dass die Informationen nicht beibehalten werden, wenn die entsprechende Registrierungsstruktur entladen wird.
Wenn der Treiber den Registrierungsschlüssel verwendet hat, den er mit WdfDeviceOpenDevicemapKey-geöffnet hat, muss der Treiber WdfRegistryCloseaufrufen.
Weitere Informationen zu den Registrierungs-, Hardware- und Softwareschlüsseln und Registrierungsobjekten finden Sie unter Verwenden der Registrierung in Framework-Based Drivers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.15 |
| Mindest-UMDF-Version | 2.15 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | PASSIVE_LEVEL |