WDF_COMMON_BUFFER_CONFIG structure (wdfcommonbuffer.h)

Article
02/26/2024

[S’applique à KMDF uniquement]

La structure WDF_COMMON_BUFFER_CONFIG contient des informations de configuration pour une mémoire tampon commune.

Syntaxe

typedef struct _WDF_COMMON_BUFFER_CONFIG {
  ULONG Size;
  ULONG AlignmentRequirement;
} WDF_COMMON_BUFFER_CONFIG, *PWDF_COMMON_BUFFER_CONFIG;

Membres

Size

Taille, en octets, de cette structure.

AlignmentRequirement

Exigence d’alignement pour une mémoire tampon commune. Cette valeur doit être inférieure à la limite d’alignement. Par exemple, vous pouvez spécifier 15 pour une limite d’alignement de 16 octets et 31 pour une limite d’alignement de 32 octets. Vous pouvez également utiliser l’une des constantes FILE_Xxxx_ALIGNMENT définies dans Wdm.h.

Remarques

La structure WDF_COMMON_BUFFER_CONFIG est utilisée comme entrée de la méthode WdfCommonBufferCreateWithConfig .

Si votre pilote spécifie une exigence d’alignement supérieure à la taille de page de l’ordinateur (PAGE_SIZE), les adresses logiques retournées par la méthode WdfCommonBufferGetAlignedLogicalAddress sont toujours alignées sur l’exigence d’alignement spécifiée, mais les adresses virtuelles retournées par la méthode WdfCommonBufferGetAlignedVirtualAddress peuvent ne pas être alignées sur l’exigence d’alignement.

Si votre pilote spécifie une exigence d’alignement inférieure à la taille de page de l’ordinateur, toutes les adresses logiques et virtuelles sont alignées sur l’exigence d’alignement spécifiée.

Pour plus d’informations sur la spécification des exigences d’alignement, consultez Activation des transactions DMA et Utilisation de mémoires tampons communes.