NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA function

Warning

Some information in this topic relates to prereleased product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

NetAdapterCx is preview only in Windows 10, version 1903.

The NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA method initializes a NET_ADAPTER_TX_CAPABILITIES structure for a net adapter that has specified the use of DMA in its transmit data path.

Syntax

void NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA(
  NET_ADAPTER_TX_CAPABILITIES  *TxCapabilities,
  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  SIZE_T                       MaximumFrameSize,
  SIZE_T                       MaximumNumberOfQueues
);

Parameters

TxCapabilities

A pointer to a driver-allocated NET_ADAPTER_TX_CAPABILITIES structure.

DmaCapabilities

A pointer to a driver-allocated and initialized NET_ADAPTER_DMA_CAPABILITIES structure.

MaximumFrameSize

MaximumNumberOfQueues

The maximum number of transmit queues that the adapter supports.

Return Value

This method does not return a value.

Remarks

This method is one of two possible methods to call in order to initialize a NET_ADAPTER_TX_CAPABILITIES structure. Which one the client driver should call depends on whether it would like to use DMA. [NET_ADAPTER_TX_CAPABILITIES_INIT(nf-netadapter-net_adapter_tx_capabilities_init.md) is used if the driver does not specify DMA memory mapping for its transmit buffers, and NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA is used if it does.

Before calling NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA, the driver must have allocated a NET_ADAPTER_DMA_CAPABILITIES structure and initialized it with NET_ADAPTER_DMA_CAPABILITIES_INIT. This DMA capabilities structure is then assigned to the DmaCapabilities member of the NET_ADAPTER_TX_CAPABILITIES structure.

Requirements

   
Target Platform Universal
Minimum KMDF version 1.25
Header netadapter.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

See Also

NET_ADAPTER_TX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES_INIT