Edit

NET_ADAPTER_LINK_LAYER_ADDRESS_INIT function (netadapter.h)

  • Article

The NET_ADAPTER_LINK_LAYER_ADDRESS_INIT function initializes a link layer address.

Syntax

void NET_ADAPTER_LINK_LAYER_ADDRESS_INIT(
  [_Out_]                    NET_ADAPTER_LINK_LAYER_ADDRESS *LinkLayerAddress,
  [_In_range_(1,32)]         USHORT                         Length,
  [_In_reads_bytes_(Length)] UCHAR const                    *AddressBuffer
);

Parameters

[_Out_] LinkLayerAddress

A pointer to the driver-allocated NET_ADAPTER_LINK_LAYER_ADDRESS structure to be initialized.

[_In_range_(1,32)] Length

The length of the link layer address, in bytes.

[_In_reads_bytes_(Length)] AddressBuffer

A pointer to the buffer containing the link layer address.

Return value

None

Remarks

NET_ADAPTER_LINK_LAYER_ADDRESS_INIT is used to initialize either a permanent or current link layer address, stored in a NET_ADAPTER_LINK_LAYER_ADDRESS allocated by the driver. This NET_ADAPTER_LINK_LAYER_ADDRESS is then passed as a parameter to either the NetAdapterSetPermanentLinkLayerAddress function or the NetAdapterSetCurrentLinkLayerAddress function, depending on the type of address that was initialized and is being set.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1709
Minimum supported server Windows Server 2016
Minimum KMDF version 1.23
Header netadapter.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

See also

NET_ADAPTER_LINK_LAYER_ADDRESS