Функция 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
Верхняя часть netadapter.h (включая netadaptercx.h)

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

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA