структура 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-байтовой границы. Можно также использовать одну из констант FILE_Xxxx_ALIGNMENT, определенных в Wdm.h.

Комментарии

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

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

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

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

Требования

Требование Значение
Минимальная версия KMDF 1,0
Верхняя часть wdfcommonbuffer.h (включая WdfCommonBuffer.h)

См. также раздел

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress