функция NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)

Статья
03/05/2024

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

Синтаксис

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES  *RxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumFrameSize,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Параметры

[_Out_] RxCapabilities

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

[_In_] DmaCapabilities

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

[_In_] MaximumFrameSize

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

[_In_] MaximumNumberOfQueues

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

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

None

Remarks

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

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

Перед вызовом NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA драйвер должен выделить структуру NET_ADAPTER_DMA_CAPABILITIES и инициализировать ее NET_ADAPTER_DMA_CAPABILITIES_INIT. Затем эта структура возможностей DMA назначается члену DmaCapabilitiesструктуры NET_ADAPTER_RX_CAPABILITIES .

Требования

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

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

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

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