共用方式為


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 交易 和使用 一般緩衝區

規格需求

需求
最低 KMDF 版本 1.0
標頭 wdfcommonbuffer.h (包含 WdfCommonBuffer.h)

另請參閱

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress