NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED function (netadapter.h)

Article
02/22/2024

The NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED function initializes a NET_ADAPTER_RX_CAPABILITIES structure for a net adapter that would like to specify operating system-managed receive buffer allocation and attachment, but not the use of DMA memory mapping.

Syntax

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

Parameters

[_Out_] RxCapabilities

A pointer to a driver-allocated NET_ADAPTER_RX_CAPABILITIES structure.

[_In_] MaximumFrameSize

The maximum frame size, in bytes, that the adapter can receive.

[_In_] MaximumNumberOfQueues

The maximum number of receive queues that the adapter supports.

Return value

None

Remarks

This function is one of three possible functions to call in order to initialize a NET_ADAPTER_RX_CAPABILITIES structure. Which one the client driver should call depends on how it would like to allocate receive buffers and if it would like to use DMA.

The client driver must call NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED to initialize its NET_ADAPTER_RX_CAPABILITIES structure if it would like the operating system to perform receive buffer allocation and attachment, but does not require DMA memory mapping. By calling this function, the Rx capabilities structure's AllocationMode member is set to NetRxFragmentBufferAllocationModeSystem and the AttachmentMode member is set to NetRxFragmentBufferAttachmentModeSystem. Because the driver does not specify DMA capabilities in this case, this function also sets the MappingRequirement member to NetMemoryMappingRequirementNone.

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.25
Header	netadapter.h (include netadaptercx.h)