Fonction WdfDeviceGetHardwareRegisterMappedAddress (wdfdevice.h)

[S’applique uniquement à UMDF]

Un pilote appelle WdfDeviceGetHardwareRegisterMappedAddress pour obtenir l’adresse mappée en mode utilisateur de la ressource de mémoire qu’il mappait précédemment à l’aide de WdfDeviceMapIoSpace.

Syntaxe

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

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

[in] PseudoBaseAddress

Adresse d’un emplacement qui reçoit un pointeur vers la pseudo adresse de base.

Valeur retournée

Adresse de base en mode utilisateur des ressources mappées précédemment à l’aide de WdfDeviceMapIoSpace.

Remarques

Cette fonction est l’équivalent UMDF version 2 de IWDFDevice3 ::GetHardwareRegisterMappedAddress.

Une fois que le pilote a appelé WdfDeviceGetHardwareRegisterMappedAddress, il peut accéder directement à l’adresse en mode utilisateur pour lire et écrire dans le registre.

Note Il ne s’agit pas de l’approche recommandée pour accéder aux registres, car elle empêche UMDF d’effectuer une validation sur l’accès.

 

Si vous utilisez WdfDeviceGetHardwareRegisterMappedAddress, vous devez définir la directive INF UmdfRegisterAccessMode sur RegisterAccessUsingUserModeMapping. Pour plus d’informations sur les directives INF UMDF, consultez Spécification de directives WDF dans les fichiers INF.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Plateforme cible	Universal
Version UMDF minimale	2.0
En-tête	wdfdevice.h (include Wdf.h)
Bibliothèque	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Voir aussi

IWDFDevice3 ::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace