NetExtensionGetFragmentVirtualAddress function (virtualaddress.h)

The NetExtensionGetFragmentVirtualAddress function retrieves the virtual address extension information for a net fragment.

Syntax

EXTERN_C_START NET_FRAGMENT_VIRTUAL_ADDRESS * NetExtensionGetFragmentVirtualAddress(
  NET_EXTENSION const *Extension,
  UINT32              Index
);

Parameters

Extension

A pointer to a NET_EXTENSION structure that describes the virtual address extension information for this fragment.

Index

The index in the fragment ring for the target NET_FRAGMENT.

Return value

Returns a pointer to a NET_FRAGMENT_VIRTUAL_ADDRESS structure that contains the virtual address information for the fragment.

Remarks

NIC client drivers typically query offsets for fragment extensions during datapath queue creation, then store them in their queue context space so they don't have to query them too often. For an example of this, see Transmit and receive queues. Clients can retrieve the virtual address offset from the queue context to pass to NetExtensionGetFragmentVirtualAddress.

This function is a wrapper function around NetExtensionGetData.

Requirements

Requirement Value
Target Platform Universal
Minimum UMDF version 2.33
Header virtualaddress.h
IRQL Any level as long as target memory is resident

See also

Transmit and receive queues

Packet descriptors and extensions

NetExtensionGetData