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 |