Edit

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA function (netadapter.h)

  • Article

The NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA function 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(
  [_Out_] NET_ADAPTER_TX_CAPABILITIES  *TxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Parameters

[_Out_] TxCapabilities

A pointer to a driver-allocated NET_ADAPTER_TX_CAPABILITIES structure.

[_In_] DmaCapabilities

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

[_In_] MaximumNumberOfQueues

The maximum number of transmit queues that the adapter supports.

Return value

None

Remarks

This function is one of two possible functions 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 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

Requirement Value
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