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 |