WdfCommonBufferGetAlignedLogicalAddress, fonction (wdfcommonbuffer.h)
[S’applique uniquement à KMDF]
La méthode WdfCommonBufferGetAlignedLogicalAddress retourne l’adresse logique associée à une mémoire tampon commune spécifiée.
Syntaxe
PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
[in] WDFCOMMONBUFFER CommonBuffer
);
Paramètres
[in] CommonBuffer
Handle vers un objet de mémoire tampon commun que le pilote a obtenu par un appel précédent à WdfCommonBufferCreate.
Valeur retournée
WdfCommonBufferGetAlignedLogicalAddress retourne l’adresse logique de la mémoire tampon associée à la mémoire tampon commune spécifiée par le paramètre CommonBuffer .
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Les adresses logiques sont des adresses mappées que les appareils utilisent pour accéder à la mémoire physique.
Si le pilote a appelé WdfDeviceSetAlignmentRequirement pour définir une exigence d’alignement de la mémoire tampon, l’infrastructure aligne la mémoire tampon commune en fonction de cette exigence d’alignement.
Pour plus d’informations sur les mémoires tampons courantes, consultez Utilisation de mémoires tampons communes
Exemples
Pour obtenir un exemple de code qui utilise WdfCommonBufferGetAlignedLogicalAddress, consultez WdfCommonBufferCreate.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfcommonbuffer.h (inclure WdfCommonBuffer.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |