WDF_COMMON_BUFFER_CONFIG structure (wdfcommonbuffer.h)
[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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version KMDF minimale | 1.0 |
| En-tête | wdfcommonbuffer.h (inclure WdfCommonBuffer.h) |
Voir aussi
WdfCommonBufferCreateWithConfig