структура 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

Требование выравнивания для общего буфера. Это значение должно быть меньше границы выравнивания. Например, можно указать 15 для границы выравнивания 16-байтов и 31 для границы выравнивания 32-байтов. Можно также использовать одну из констант xxxx_ALIGNMENT FILE_, определенных в Wdm.h.

Замечания

Структура WDF_COMMON_BUFFER_CONFIG используется в качестве входных данных для метода WdfCommonBufferCreateWithConfig.

Если драйвер указывает требование выравнивания, которое больше размера страницы компьютера (PAGE_SIZE), логические адреса, которые возвращаются WdfCommonBufferGetAlignedLogicalAddress, всегда соответствуют указанному требованию выравнивания. но виртуальные адреса, возвращаемые метод ом WdfCommonBuffonBufferGetAlignedVirtualAddress, могут не соответствовать требованию выравнивания.

Если драйвер задает требование выравнивания, которое меньше размера страницы компьютера, все логические и виртуальные адреса соответствуют указанному требованию выравнивания.

Дополнительные сведения об указании требований к выравниванию см. в статье Включение транзакций DMA и использование общих буферов.

Требования

См. также

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress