WDF_COMMON_BUFFER_CONFIG 構造体 (wdfcommonbuffer.h)

[アーティクル]
02/26/2024

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