NetAdapterInitAllocate-Funktion (netadapter.h)

Die NetAdapterInitAllocate-Funktion weist eine NETADAPTER_INIT Struktur zu, die ein Clienttreiber beim Erstellen eines neuen NETADAPTER-Objekts verwendet.

Syntax

NETADAPTER_INIT * NetAdapterInitAllocate(
  [_In_] WDFDEVICE Device
);

Parameter

[_In_] Device

Ein Handle für ein Framework-Geräteobjekt.

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.

Hinweise

Ein Clienttreiber ruft NetAdapterInitAllocate auf, um eine NETADAPTER_INIT-Struktur abzurufen, die er an NetAdapterCreate übergeben kann.

Nachdem NetAdapterInitAllocate erfolgreich war, können Clienttreiber optional NetAdapterInitSetXxx-Funktionen aufrufen, um weitere Initialisierungsattribute für den NETADAPTER festzulegen.

Ein Codebeispiel zum Erstellen eines NETADAPTER finden Sie unter Geräteinitialisierung.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1,27
UMDF-Mindestversion	2.33
Kopfzeile	netadapter.h (include netadaptercx.h)
Bibliothek	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

Geräteinitialisierung

NetAdapterCreate

NetAdapterInitFree