EVT_MBB_DEVICE_CREATE_ADAPTER Rückruffunktion (mbbcx.h)

Die EvtMbbDeviceCreateAdapter Rückruffunktion wird vom Clienttreiber implementiert, um ein NETADAPTER-Objekt für eine Datensitzung zu erstellen.

Syntax

EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;

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

Parameter

Device

Ein Handle zu einem Framework-Geräteobjekt, das der Clienttreiber aus einem vorherigen Aufruf von WdfDeviceCreateabgerufen hat.

AdapterInit

Ein NETADAPTER_INIT-Objekt, das die Initialisierungsinformationen für den NETADAPTER beschreibt.

Rückgabewert

Diese Rückruffunktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich war. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Ein MBBCx-Clienttreiber muss einen EvtMbbDeviceCreateAdapter Rückruffunktion registrieren, indem MbbDeviceInitializeaufgerufen wird.

In diesem Rückruf erstellt der Clienttreiber ein NETADAPTER-Objekt, das von MBBCx verwendet wird, um die Netzwerkschnittstelle für eine Datensitzung darzustellen. MBBCx ruft diese Rückruffunktion mindestens einmal auf, um den primären PDP-Kontext/den standardmäßigen EPS-Bearer einzurichten, und es kann dann mehr Mal aufgerufen werden, wenn jede Datensitzung eingerichtet wird.

Vor der Rückgabe von EvtMbbDeviceCreateAdaptermüssen Clienttreiber den Adapter starten, indem NetAdapterStart-aufgerufen wird. Optional können sie auch die Funktionen des Adapters festlegen, indem sie eine oder mehrere dieser Funktionen aufrufen, bevor sie den Aufruf von NetAdapterStart-:

• NetAdapterSetDatapathCapabilities
• NetAdapterSetLinkLayerCapabilities
• NetAdapterSetLinkLayerMtuSize

Weitere Informationen und ein Codebeispiel finden Sie unter Creating the NetAdapter interface for the PDP context/EPS bearer.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1903
Zielplattform-	Universal
Minimale KMDF-Version	1.29
Header-	mbbcx.h
IRQL-	PASSIVE_LEVEL