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_FOR_DMA，则使用 NET_ADAPTER_TX_CAPABILITIES_INIT。
在调用 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 |