Partager via


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 obtenu par un appel précédent à WdfCommonBufferCreate.

Valeur de retour

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.

Une vérification de bogue 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 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 courantes

Exemples

Pour obtenir un exemple de code qui utilise WdfCommonBufferGetAlignedLogicalAddress, consultez WdfCommonBufferCreate.

Exigences

Exigence Valeur
plateforme cible Universel
version minimale de KMDF 1.0
d’en-tête wdfcommonbuffer.h (include WdfCommonBuffer.h)
bibliothèque Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL <= DISPATCH_LEVEL
règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement