Méthode IWDFDevice3 ::GetHardwareRegisterMappedAddress (wudfddi.h)

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

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

Syntaxe

void * GetHardwareRegisterMappedAddress(
  [in] void *PseudoBaseAddress
);

Paramètres

[in] PseudoBaseAddress

Pointeur vers la pseudo adresse de base retournée par un appel précédent à MapIoSpace.

Valeur retournée

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

Remarques

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

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

 

Pour plus d’informations, consultez Lecture et écriture dans les registres de périphériques dans les pilotes UMDF 1.x.

Si vous utilisez GetHardwareRegisterMappedAddress, 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
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.11
En-tête	wudfddi.h
DLL	WUDFx.dll

Voir aussi

IWDFDevice3