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