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

Статья
02/07/2025

Функция NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA инициализирует структуру NET_ADAPTER_TX_CAPABILITIES для сетевого адаптера, который указал использование DMA в пути передачи данных.

Синтаксис

void NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA(
  [_Out_] NET_ADAPTER_TX_CAPABILITIES  *TxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Параметры

[_Out_] TxCapabilities

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

[_In_] DmaCapabilities

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

[_In_] MaximumNumberOfQueues

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

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

Никакой

Замечания

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

Перед вызовом NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMAдрайвер должен выделить структуру NET_ADAPTER_DMA_CAPABILITIES и инициализировать ее с помощью NET_ADAPTER_DMA_CAPABILITIES_INIT. Затем эта структура возможностей DMA назначается элементу структуры NET_ADAPTER_TX_CAPABILITIES DmaCapabilities.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.25
заголовка	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

См. также

NET_ADAPTER_TX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES_INIT

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