EVT_MBB_DEVICE_CREATE_ADAPTER callback function

Warning

Some information in this topic relates to prereleased product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

MBBCx is preview only in Windows 10, version 1903.

The EvtMbbDeviceCreateAdapter callback function is implemented by the client driver to create a NETADAPTER object for a data session.

Syntax

EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;

NTSTATUS EvtMbbDeviceCreateAdapter(
  WDFDEVICE Device,
  NETADAPTER_INIT *AdapterInit
)
{...}

Parameters

Device

A handle to a framework device object the client driver obtained from a previous call to WdfDeviceCreate.

AdapterInit

A NETADAPTER_INIT object that describes the initialization information for the NETADAPTER.

Return Value

This callback function returns STATUS_SUCCESS if the operation was successful. Otherwise, it returns an appropriate NTSTATUS error code.

Remarks

An MBBCx client driver must register an EvtMbbDeviceCreateAdapter callback function by calling MbbDeviceInitialize.

In this callback, the client driver creates a NETADAPTER object that is used by MBBCx to represent the network interface for a data session. MBBCx invokes this callback function at least once to establish the primary PDP context/default EPS bearer, then it might invoke it more times, once for every data session to be established.

Before returning from EvtMbbDeviceCreateAdapter, client drivers must start the adapter by calling NetAdapterStart. Optionally, they can also set the adapter's capabilities by calling one or more of these functions before the call to NetAdapterStart:

For more information and a code example, see Creating the NetAdapter interface for the PDP context/EPS bearer.

Requirements

   
Minimum supported client Windows 10, version 1903
Target Platform Universal
Minimum KMDF version 1.29
Header mbbcx.h
IRQL PASSIVE_LEVEL