Intel Extensible Firmware Interface, Specification

Page: 307 / 494

SIMPLE_NETWORK Protocol
Version 1.02 12/12/00 289
15.1.7 EFI_SIMPLE_NETWO RK.StationAddress()
Summary
Modifies or resets the current station address, if supported.
Prototype
EFI_STATUS
(EFIAPI *EFI_SIMPLE_NETWORK_STATION_ADDRESS) (
IN EFI_SIMPLE_NETWORK *This,
IN BOOLEAN Reset,
IN EFI_MAC_ADDRESS *New OPTIONAL
);
Parameters
This
A pointer to the
EFI_SIMPLE_NETWORK
instance.
Reset
Flag used to reset the station address to the network interface’s
permanent address.
New
New station address to be used for the network interface.
Description
This function modifies or resets the current station address of a network interface, if supported. If
Reset
is
TRUE
, then the current station address is set to the network interface's permanent
address. If
Reset
is
FALSE
, and the network interface allows its station address to be modified,
then the current station address is changed to the address specified by
New
. If the network interface
does not allow its station address to be modified, then
EFI_INVALID_PARAMETER
will be
returned. If the station address is successfully updated on the network interface,
EFI_SUCCESS
will be returned. If the driver has not been initialized,
EFI_DEVICE_ERROR
will be returned.
Status Codes Returned
EFI_SUCCESS The network interface’s station address was updated.
EFI_NOT_STARTED The network interface has not been started.
EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
EFI_DEVICE_ERROR The command could not be sent to the network interface.
EFI_UNSUPPORTED This function is not supported by the network interface.