structure WDF_COMMON_BUFFER_CONFIG (wdfcommonbuffer.h)

[S’applique uniquement à KMDF]

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_ALIGNMENT xxxx FILE_définies dans Wdm.h.

Remarques

La structure WDF_COMMON_BUFFER_CONFIG est utilisée comme entrée dans 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 renvoyées par la méthode WdfCommonBufferGetAlignedLogicalAddress sont toujours alignées sur l’exigence d’alignement spécifiée, mais les adresses virtuelles renvoyé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 des mémoires tampons courantes.

Exigences

Voir aussi

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress