WDF_COMMON_BUFFER_CONFIG 结构 (wdfcommonbuffer.h)

[仅适用于 KMDF]

WDF_COMMON_BUFFER_CONFIG 结构包含公共缓冲区的配置信息。

语法

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

Size

此结构的大小（以字节为单位）。

AlignmentRequirement

公共缓冲区的对齐要求。此值必须小于对齐边界的 1。例如，可以为 16 字节对齐边界指定 15，为 32 字节对齐边界指定 31。还可以使用 Wdm.h 中定义的FILE_Xxxx_ALIGNMENT常量之一。

WDF_COMMON_BUFFER_CONFIG 结构用作 WdfCommonBufferCreateWithConfig 方法的输入。

如果驱动程序指定的对齐要求大于计算机的页大小 (PAGE_SIZE) ，则 WdfCommonBufferGetAlignedLogicalAddress 方法返回的逻辑地址始终与指定的对齐要求对齐，但 WdfCommonBufferGetAlignedVirtualAddress 方法返回的虚拟地址可能与对齐要求不一致。

如果驱动程序指定的对齐要求小于计算机的页面大小，则所有逻辑地址和虚拟地址都与指定的对齐要求保持一致。

有关指定对齐要求的详细信息，请参阅启用 DMA 事务和使用通用缓冲区。