WdfCommonBufferGetAlignedLogicalAddress, fonction (wdfcommonbuffer.h)

  • Article

[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)

Voir aussi

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement