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

Статья
05/23/2024

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

Синтаксис

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_In_]  SIZE_T                           MaximumFrameSize,
  [_In_]  SIZE_T                           MaximumNumberOfQueues
);

Параметры

[_Out_] RxCapabilities

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

[_In_] EvtAdapterReturnRxBuffer

Указатель на функцию обратного вызова EVT_NET_ADAPTER_RETURN_RX_BUFFER драйвера клиента. Дополнительные сведения см. в разделе «Примечания».

[_In_] MaximumFrameSize

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

[_In_] MaximumNumberOfQueues

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

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

None

Remarks

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

Драйвер клиента должен вызвать NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED для инициализации структуры NET_ADAPTER_RX_CAPABILITIES , если он хочет выполнить выделение буфера приема и вложение вручную. При вызове этой функции для элемента AllocationMode структуры возможностей Rx устанавливается значение NetRxFragmentBufferAllocationModeDriver , а для элемента AttachmentMode — значение NetRxFragmentBufferAttachmentModeDriver. В этом случае он также должен предоставить указатель на свою EVT_NET_ADAPTER_RETURN_RX_BUFFER функцию обратного вызова в структуре, чтобы операционная система вызывала после завершения работы системы с буфером приема.

Требования

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

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

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA

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