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

Статья
02/27/2024

Функция 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

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

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

None

Remarks

Эта функция является одной из двух возможных функций для инициализации структуры 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 назначается члену DmaCapabilitiesструктуры NET_ADAPTER_TX_CAPABILITIES .

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,25
Верхняя часть	netadapter.h (включая netadaptercx.h)
IRQL	PASSIVE_LEVEL

См. также раздел

NET_ADAPTER_TX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES_INIT

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