Share via

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA 函数 (netadapter.h)

  • 项目

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA 函数初始化已指定在其传输数据路径中使用 DMA 的 net 适配器的NET_ADAPTER_TX_CAPABILITIES结构。

语法

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。 如果驱动程序未为其传输缓冲区指定 DMA 内存映射，则使用NET_ADAPTER_TX_CAPABILITIES_INIT;如果指定，则使用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 (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL

另请参阅

NET_ADAPTER_TX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES_INIT