NetAdapterInitSetDatapathCallbacks function (netadapter.h)

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
Minimum UMDF version 2.33
Header netadapter.h (include netadaptercx.h)
Library netadaptercxstub.lib
IRQL PASSIVE_LEVEL

See also

Device initialization

NetAdapterInitAllocate

NetAdapterInitFree

NetAdapterCreate