Freigeben über


WdfDeviceGetHardwareRegisterMappedAddress-Funktion (wdfdevice.h)

[Gilt nur für UMDF]

Ein Treiber ruft WdfDeviceGetHardwareRegisterMappedAddress auf, um die zugeordnete Benutzermodusadresse der speicherressource abzurufen, die er zuvor mit WdfDeviceMapIoSpacezugeordnet hat.

Syntax

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

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] PseudoBaseAddress

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

Rückgabewert

Basisadresse des Benutzermodus der zuvor zugeordneten Ressourcen mithilfe von WdfDeviceMapIoSpace.

Bemerkungen

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

Nachdem der Treiber WdfDeviceGetHardwareRegisterMappedAddressaufgerufen 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 sie verhindert, dass UMDF eine Überprüfung für den Zugriff durchführt.
 

Wenn Sie WdfDeviceGetHardwareRegisterMappedAddressverwenden, müssen Sie die UmdfRegisterAccessMode INF-Direktive so festlegen, dass RegisterAccessUsingUserModeMapping. Weitere Informationen zu UMDF INF-Direktiven finden Sie unter Angeben von WDF-Direktiven in INF-Dateien.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8.1
Zielplattform- Universal
Mindest-UMDF-Version 2.0
Header- wdfdevice.h (einschließen Wdf.h)
Library WUDFx02000.lib
DLL- WUDFx02000.dll
IRQL- PASSIVE_LEVEL

Siehe auch

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace-