Fonction WdfCommonBufferGetLength (wdfcommonbuffer.h)
[S’applique uniquement à KMDF]
La méthode WdfCommonBufferGetLength retourne la longueur d’une mémoire tampon commune spécifiée.
Syntaxe
size_t WdfCommonBufferGetLength(
[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
WdfCommonBufferGetLength retourne la longueur, en octets, 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
Pour plus d’informations sur les mémoires tampons courantes, consultez Utilisation de mémoires tampons communes
Exemples
L’exemple de code suivant obtient la longueur d’une mémoire tampon commune spécifiée.
size_t bufferLength;
bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);
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) |