WdfCommonBufferGetAlignedVirtualAddress, fonction (wdfcommonbuffer.h)

  • Article

[S’applique à KMDF uniquement]

La méthode WdfCommonBufferGetAlignedVirtualAddress retourne l’adresse virtuelle associée à une mémoire tampon commune spécifiée.

Syntaxe

PVOID WdfCommonBufferGetAlignedVirtualAddress(
  [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

WdfCommonBufferGetAlignedVirtualAddress retourne l’adresse virtuelle 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

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 WdfCommonBufferGetAlignedVirtualAddress, 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 des versions 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

WdfCommonBufferGetAlignedLogicalAddress

WdfDeviceSetAlignmentRequirement