функция обратного вызова 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_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