WdfDeviceGetHardwareRegisterMappedAddress-Funktion (wdfdevice.h)

[Gilt nur für UMDF]

Ein Treiber ruft WdfDeviceGetHardwareRegisterMappedAddress auf, um die im Benutzermodus zugeordnete Adresse der Speicherressource abzurufen, die er zuvor mithilfe von WdfDeviceMapIoSpace zugeordnet hat.

Syntax

PVOID WdfDeviceGetHardwareRegisterMappedAddress(
  [in] WDFDEVICE Device,
  [in] PVOID     PseudoBaseAddress
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] PseudoBaseAddress

Die Adresse eines Speicherorts, der einen Zeiger auf die Pseudobasisadresse empfängt.

Rückgabewert

Basisadresse des Benutzermodus der ressourcen, die zuvor mithilfe von WdfDeviceMapIoSpace zugeordnet wurden.

Hinweise

Diese Funktion ist die UMDF-Version 2-Entsprechung von IWDFDevice3::GetHardwareRegisterMappedAddress.

Nachdem der Treiber WdfDeviceGetHardwareRegisterMappedAddress aufgerufen hat, kann er direkt auf die Benutzermodusadresse zugreifen, um das Register zu lesen und zu schreiben.

Hinweis Dies ist nicht der empfohlene Ansatz für den Zugriff auf Register, da er verhindert, dass UMDF eine Überprüfung des Zugriffs durchführt.

 

Wenn Sie WdfDeviceGetHardwareRegisterMappedAddress verwenden, müssen Sie die Inf-Direktive UmdfRegisterAccessMode auf RegisterAccessUsingUserModeMapping festlegen. Weitere Informationen zu UMDF INF-Anweisungen finden Sie unter Angeben von WDF-Direktiven in INF-Dateien.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Zielplattform	Universell
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Weitere Informationen

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace