NetAdapterCreate-Funktion (netadapter.h)

Artikel
02/07/2025

Erstellt ein NETADAPTER-Objekt.

Syntax

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

Parameter

[_In_] AdapterInit

Ein Zeiger auf eine NETADAPTER_INIT Struktur, die der Clienttreiber zuvor von einem Aufruf von NetAdapterInitAllocateempfangen hat.

[_In_opt_] AdapterAttributes

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur. Die ParentObject- der Struktur muss NULL-sein. Der Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[_Out_] Adapter

Ein Zeiger auf eine Position, die ein Handle für das neue NETADAPTER-Objekt empfängt.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.

Bemerkungen

Nachdem sie WdfDeviceCreateaufgerufen hat, ruft der Client in der Regel NetAdapterCreate aus seiner EvtDriverDeviceAdd- Routine auf.

Ein Codebeispiel zum Erstellen eines NETADAPTERs finden Sie unter Device Initialization.

Das NETADAPTER-Objekt ist ein WDF-Standardobjekt. Das Framework verwaltet den Löschvorgang, der auftritt, wenn das übergeordnete WDFDEVICE gelöscht wird.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.27
Mindest-UMDF-Version	2.33
Header-	netadapter.h (include netadaptercx.h)
Library	NetAdapterCxStub.lib
IRQL-	PASSIVE_LEVEL

Freigeben über