WDF_ALIGN_SIZE_DOWN, fonction (wdfcore.h)

[S’applique à KMDF et UMDF]

La fonction WDF_ALIGN_SIZE_DOWN retourne la taille de mémoire tampon inférieure suivante qui est alignée sur un décalage d’alignement spécifié.

Syntaxe

size_t WDF_ALIGN_SIZE_DOWN(
  [in] size_t Length,
  [in] size_t AlignTo
);

Paramètres

[in] Length

Longueur, en octets, d’une mémoire tampon.

[in] AlignTo

Décalage d’alignement, en octets. Cette valeur doit être une puissance de 2, par exemple 2, 4, 8, 16, etc.

Valeur retournée

WDF_ALIGN_SIZE_DOWN retourne la taille de mémoire tampon alignée, en octets.

Remarques

Les pilotes peuvent utiliser WDF_ALIGN_SIZE_UP ou WDF_ALIGN_SIZE_DOWN pour calculer une taille de mémoire tampon alignée sur un décalage d’alignement spécifié. Ce calcul est utile si votre pilote doit allouer plusieurs mémoires tampons contiguës, si chaque mémoire tampon doit commencer à une limite d’alignement d’adresse.

Exemples

L’exemple de code suivant reçoit une taille de mémoire tampon et retourne la taille (la taille actuelle ou la taille inférieure suivante) qui s’aligne sur une limite d’adresse DWORD.

bufferSizeAligned = WDF_ALIGN_SIZE_DOWN(bufferSize,
                                        sizeof(DWORD));

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfcore.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	N’importe quel IRQL.

Voir aussi

WDF_ALIGN_SIZE_UP