функция обратного вызова EVT_MBB_DEVICE_CREATE_ADAPTER (mbbcx.h)

Статья
02/07/2025

Функция обратного вызова EvtMbbDeviceCreateAdapter реализована драйвером клиента для создания объекта NETADAPTER для сеанса данных.

Синтаксис

EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;

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

Параметры

Device

Дескриптор объекта устройства платформы, полученный из предыдущего вызова WdfDeviceCreate.

AdapterInit

Объект NETADAPTER_INIT, описывающий сведения об инициализации для NETADAPTER.

Возвращаемое значение

Эта функция обратного вызова возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращается соответствующий код ошибки NTSTATUS.

Замечания

Драйвер клиента MBBCx должен зарегистрировать функцию обратного вызова EvtMbbDeviceCreateAdapter путем вызова MbbDeviceInitialize.

В этом обратном вызове драйвер клиента создает объект NETADAPTER, используемый MBBCx для представления сетевого интерфейса для сеанса данных. MBBCx вызывает эту функцию обратного вызова по крайней мере один раз, чтобы установить основной контекст PDP/носитель EPS по умолчанию, то он может вызывать его несколько раз, один раз для каждого сеанса данных, который необходимо установить.

Перед возвращением из EvtMbbDeviceCreateAdapterклиентские драйверы должны запустить адаптер, вызвав NetAdapterStart. При необходимости они также могут задать возможности адаптера, вызвав одну или несколько этих функций перед вызовом NetAdapterStart:

Дополнительные сведения и пример кода см. в создании интерфейса NetAdapter для контекста PDP/носителя EPS.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1903
целевая платформа	Всеобщий
минимальная версия KMDF	1.29
заголовка	mbbcx.h
IRQL	PASSIVE_LEVEL

Поделиться через