Поделиться через

Функция NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)

  • Статья

Функция NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED инициализирует структуру NET_ADAPTER_RX_CAPABILITIES для сетевого адаптера, который хотел бы указать выделение и вложение буфера приема, управляемого операционной системой, но не использует сопоставление памяти DMA.

Синтаксис

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

Параметры

[_Out_] RxCapabilities

Указатель на структуру, выделенную драйвером NET_ADAPTER_RX_CAPABILITIES .

[_In_] MaximumFrameSize

Максимальный размер кадра в байтах, который может получить адаптер.

[_In_] MaximumNumberOfQueues

Максимальное число очередей получения, поддерживаемых адаптером.

Возвращаемое значение

None

Remarks

Эта функция является одной из трех возможных функций для вызова для инициализации структуры NET_ADAPTER_RX_CAPABILITIES . Какой из них следует вызвать драйверу клиента, зависит от того, как он хочет выделить буферы приема и использовать ли он DMA.

Драйвер клиента должен вызвать NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED для инициализации структуры NET_ADAPTER_RX_CAPABILITIES , если операционная система должна получать выделение буфера и вложение, но не требует сопоставления памяти DMA. При вызове этой функции для элемента AllocationMode структуры возможностей Rx устанавливается значение NetRxFragmentBufferAllocationModeSystem , а для элемента AttachmentMode — Значение NetRxFragmentBufferAttachmentModeSystem. Так как драйвер не указывает возможности DMA в этом случае, эта функция также задает для члена MappingRequirement значение NetMemoryMappingRequirementNone.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,25
Минимальная версия UMDF 2.33
Верхняя часть netadapter.h (включая netadaptercx.h)

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

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA