WdfCommonBufferGetAlignedVirtualAddress, fonction (wdfcommonbuffer.h)
[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) |