Partager via


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

Valeur de retour

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 .

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

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

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