EVT_MBB_DEVICE_CREATE_ADAPTER fonction de rappel (mbbcx.h)

La fonction de rappel EvtMbbDeviceCreateAdapter est implémentée par le pilote client pour créer un objet NETADAPTER pour une session de données.

Syntaxe

EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;

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

Paramètres

Device

Handle pour un objet d’appareil d’infrastructure que le pilote client a obtenu à partir d’un appel précédent à WdfDeviceCreate.

AdapterInit

Objet NETADAPTER_INIT qui décrit les informations d’initialisation de NETADAPTER.

Valeur retournée

Cette fonction de rappel retourne STATUS_SUCCESS si l’opération a réussi. Sinon, elle retourne un code d’erreur NTSTATUS approprié.

Remarques

Un pilote client MBBCx doit inscrire une fonction de rappel EvtMbbDeviceCreateAdapter en appelant MbbDeviceInitialize.

Dans ce rappel, le pilote client crée un objet NETADAPTER utilisé par MBBCx pour représenter l’interface réseau d’une session de données. MBBCx appelle cette fonction de rappel au moins une fois pour établir le contexte PDP principal/le porteur EPS par défaut, puis il peut l’appeler plusieurs fois, une fois pour chaque session de données à établir.

Avant de revenir d’EvtMbbDeviceCreateAdapter, les pilotes clients doivent démarrer l’adaptateur en appelant NetAdapterStart. Si vous le souhaitez, ils peuvent également définir les fonctionnalités de l’adaptateur en appelant une ou plusieurs de ces fonctions avant l’appel à NetAdapterStart :

• NetAdapterSetDatapathCapabilities
• NetAdapterSetLinkLayerCapabilities
• NetAdapterSetLinkLayerMtuSize

Pour plus d’informations et un exemple de code, consultez Création de l’interface NetAdapter pour le contexte PDP/porteur EPS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1903
Plateforme cible	Universal
Version KMDF minimale	1.29
En-tête	mbbcx.h
IRQL	PASSIVE_LEVEL