Intel Extensible Firmware Interface Network Router User Manual


  Open as PDF
of 1084
 
Protocols Network Support
Version 1.10 12/01/02 15-13
EFI_SIMPLE_NETWORK.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 interfaces
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 interfaces 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.