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

  • Статья

Функция 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
Верхняя часть 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