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

一般緩衝區的對齊需求。此值必須小於對齊界限。例如，您可以為16位元組對齊界限指定15，而32位元組對齊界限則指定31。您也可以使用 Wdm.h 中定義的其中一個FILE_Xxxx_ALIGNMENT常數。

WDF_COMMON_BUFFER_CONFIG 結構會當做 WdfCommonBufferCreateWithConfig 方法的輸入使用。

如果您的驅動程式指定的對齊需求大於計算機的頁面大小 (PAGE_SIZE) ，WdfCommonBufferGetAlignedLogicalAddress 方法傳回的邏輯位址一律會對齊指定的對齊需求，但 WdfCommonBufferGetAlignedVirtualAddress 方法傳回的虛擬位址可能無法對齊對齊需求。

如果您的驅動程式指定小於計算機頁面大小的對齊需求，則所有邏輯和虛擬位址都會對齊指定的對齊需求。

如需指定對齊需求的詳細資訊，請參閱啟用 DMA 交易和使用一般緩衝區。