функция NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)
Функция 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
Максимальное количество очередей получения, поддерживаемых адаптером.
Возвращаемое значение
Никакой
Замечания
Эта функция является одной из трех возможных функций для вызова для инициализации структуры 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 назначается элементу структуры NET_ADAPTER_RX_CAPABILITIES DmaCapabilities.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.25 |
| заголовка | netadapter.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |