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之前调用其中一个或多个函数来设置适配器的功能

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

要求

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