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