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 vers un objet d’appareil framework que le pilote client obtenu à partir d’un appel précédent à WdfDeviceCreate.

AdapterInit

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

Valeur de retour

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 porteur PDP principal/le porteur EPS par défaut, puis il peut l’appeler plus de fois, une fois pour chaque session de données à établir.

Avant de revenir de 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 d' l’appel à NetAdapterStart:

• NetAdapterSetDatapathCapabilities
• NetAdapterSetLinkLayerCapabilities
• NetAdapterSetLinkLayerMtuSize

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1903
plateforme cible	Universel
version minimale de KMDF	1.29
d’en-tête	mbbcx.h
IRQL	PASSIVE_LEVEL