функция 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
Максимальное количество очередей получения, поддерживаемых адаптером.
Возвращаемое значение
Никакой
Замечания
Эта функция является одной из трех возможных функций для вызова для инициализации структуры 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 (include netadaptercx.h) |