次の方法で共有


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 トランザクション の有効化と共通バッファー の使用」を参照してください。

必要条件

要件 価値
最小 KMDF バージョン 1.0
ヘッダー wdfcommonbuffer.h (WdfCommonBuffer.h を含む)

関連項目

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress