NetAdapterLightweightInitAllocate function (netadapter.h)

The NetAdapterLightweightInitAllocate function allocates a NETADAPTER_INIT structure that a client driver uses when creating a new NETADAPTER object for a deviceless adapter.

Syntax

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

Parameters

[_In_] NetworkInterfaceGuid

The GUID of a valid network interface using the to-be-created deviceless adapter.

Return value

Returns a pointer to a framework-allocated NETADAPTER_INIT structure if the operation succeeds. Otherwise, this function returns NULL.

Important

If a client driver receives a NETADAPTER_INIT structure from a successful call to this function, the driver must always call NetAdapterInitFree to deallocate it regardless of the result of NetAdapterCreate.

Requirements

Requirement Value
Minimum supported client Windows 11, version 22H2
Minimum UMDF version 2.33
Header netadapter.h
IRQL PASSIVE_LEVEL

See also

Device initialization

NetAdapterCreate

NetAdapterInitFree