EVT_MBB_DEVICE_CREATE_ADAPTER回调函数 (mbbcx.h)

EvtMbbDeviceCreateAdapter 回调函数由客户端驱动程序实现，以便为数据会话创建 NETADAPTER 对象。

语法

EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;

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

参数

Device

从上一次调用 WdfDeviceCreate 获取的客户端驱动程序的框架设备对象的句柄。

AdapterInit

描述 NETADAPTER 初始化信息的 NETADAPTER_INIT 对象。

返回值

如果操作成功，此回调函数将返回STATUS_SUCCESS。 否则，它将返回相应的 NTSTATUS 错误代码。

注解

MBBCx 客户端驱动程序必须通过调用 MbbDeviceInitialize 注册 EvtMbbDeviceCreateAdapter 回调函数。

在此回调中，客户端驱动程序创建一个 NETADAPTER 对象，MBBCx 使用该对象来表示数据会话的网络接口。 MBBCx 调用此回调函数至少一次以建立主 PDP 上下文/默认 EPS 持有者，然后它可能会多次调用它，每次建立一次数据会话。

在从 EvtMbbDeviceCreateAdapter 返回之前，客户端驱动程序必须通过调用 NetAdapterStart 来启动适配器。 （可选）他们还可以通过在调用 NetAdapterStart之前调用以下一个或多个函数来设置适配器的功能：

• NetAdapterSetDatapathCapabilities
• NetAdapterSetLinkLayerCapabilities
• NetAdapterSetLinkLayerMtuSize

有关详细信息和代码示例，请参阅 为 PDP 上下文/EPS 持有者创建 NetAdapter 接口。

要求

要求	值
最低受支持的客户端	Windows 10 版本 1903
目标平台	通用
最低 KMDF 版本	1.29
标头	mbbcx.h
IRQL	PASSIVE_LEVEL