NetAdapterCreate-Funktion (netadapter.h)

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 NetAdapterInitAllocate empfangen hat.

[_In_opt_] AdapterAttributes

Ein Zeiger auf eine aufruferseitig zugewiesene WDF_OBJECT_ATTRIBUTES-Struktur . Das 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 auf 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 entsprechenden NTSTATUS-Fehlercode zurück.

Hinweise

Nachdem er WdfDeviceCreate aufgerufen hat, ruft der Client in der Regel NetAdapterCreate aus seiner EvtDriverDeviceAdd-Routine auf.

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

Das NETADAPTER-Objekt ist ein WDF-Standardobjekt. Das Framework verwaltet seine Löschung, die auftritt, wenn das übergeordnete WDFDEVICE gelöscht wird.

Anforderungen