EVT_MBB_DEVICE_CREATE_ADAPTER Rückruffunktion (mbbcx.h)

Die Rückruffunktion EvtMbbDeviceCreateAdapter 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 für ein Framework-Geräteobjekt, das der Clienttreiber aus einem vorherigen Aufruf von WdfDeviceCreate abgerufen 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.

Hinweise

Ein MBBCx-Clienttreiber muss eine EvtMbbDeviceCreateAdapter-Rückruffunktion registrieren, indem MbbDeviceInitialize aufgerufen 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 bzw. den STANDARDMÄßIGen EPS-Bearer festzulegen. Anschließend wird er möglicherweise mehrmals aufgerufen, einmal für jede zu erstellende Datensitzung.

Vor der Rückkehr von EvtMbbDeviceCreateAdapter müssen Clienttreiber den Adapter starten, indem sie NetAdapterStart aufrufen. Optional können sie auch die Funktionen des Adapters festlegen, indem sie vor dem Aufruf von NetAdapterStart eine oder mehrere dieser Funktionen aufrufen:

• NetAdapterSetDatapathCapabilities
• NetAdapterSetLinkLayerCapabilities
• NetAdapterSetLinkLayerMtuSize

Weitere Informationen und ein Codebeispiel finden Sie unter Erstellen der NetAdapter-Schnittstelle für den PDP-Kontext/EPS-Bearer.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1903
Zielplattform	Universell
KMDF-Mindestversion	1.29
Kopfzeile	mbbcx.h
IRQL	PASSIVE_LEVEL