NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA function (netadapter.h)
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 |