NetAdapterInitSetDatapathCallbacks function (netadapter.h)

Article
02/22/2024

The NetAdapterInitSetDatapathCallbacks function sets a net adapter's callback functions for creating datapath packet queues.

Syntax

void NetAdapterInitSetDatapathCallbacks(
  [_Inout_] NETADAPTER_INIT                *AdapterInit,
  [_In_]    NET_ADAPTER_DATAPATH_CALLBACKS *DatapathCallbacks
);

Parameters

[_Inout_] AdapterInit

A pointer to a NETADAPTER_INIT structure that the driver obtained from a previous call to NetAdapterInitAllocate.

[_In_] DatapathCallbacks

A pointer to a driver-allocated and initialized NET_ADAPTER_DATAPATH_CALLBACKS structure that contains pointers to the adapter's datapath queue creation callback functions.

Return value

None

Remarks

This is an optional function. If a client driver does not provide its own packet queue creation handlers, NetAdapterCx provides default handlers on the driver's behalf.

Call this function after calling NetAdapterInitAllocate but before calling NetAdapterCreate.

If the driver encounters an error after the NETADAPTER_INIT allocation succeeds but before NetAdapterCreate succeeds, it must call NetAdapterInitFree to deallocate the NETADAPTER_INIT object.

For a code example of creating a NETADAPTER, see Device initialization.

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.27
Header	netadapter.h (include netadaptercx.h)
Library	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL