Freigeben über


NetAdapterLightweightInitAllocate-Funktion (netadapter.h)

Die NetAdapterLightweightInitAllocate-Funktion weist eine NETADAPTER_INIT-Struktur zu, die ein Clienttreiber beim Erstellen eines neuen NETADAPTER-Objekts für einen gerätelosen Adapter verwendet.

Syntax

NETADAPTER_INIT * NetAdapterLightweightInitAllocate(
  [_In_] const GUID *NetworkInterfaceGuid
);

Parameter

[_In_] NetworkInterfaceGuid

Die GUID einer gültigen Netzwerkschnittstelle, die den zu erstellenden gerätelosen Adapter verwendet.

Rückgabewert

Gibt einen Zeiger auf eine vom Framework zugewiesene NETADAPTER_INIT-Struktur zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion NULL zurück.

Wichtig

Wenn ein Clienttreiber eine NETADAPTER_INIT Struktur von einem erfolgreichen Aufruf dieser Funktion empfängt, muss der Treiber immer NetAdapterInitFree aufrufen, um die Zuordnung unabhängig vom Ergebnis von NetAdapterCreate zu beheben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2
UMDF-Mindestversion 2.33
Kopfzeile netadapter.h
IRQL PASSIVE_LEVEL

Weitere Informationen

Geräteinitialisierung

NetAdapterCreate

NetAdapterInitFree