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

  • Статья

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