- This is the SNP interface routine for changing the NIC's mac address.\r
- This routine basically retrieves snp structure, checks the SNP state and\r
- calls the above routines to actually do the work\r
-\r
- @param this context pointer\r
- @param NewMacAddr pointer to a mac address to be set for the nic, if this is\r
- NULL then this routine resets the mac address to the NIC's\r
- original address.\r
- @param ResetFlag If true, the mac address will change to NIC's original\r
- address\r
-\r
+ Modifies or resets the current station address, if supported.\r
+\r
+ This function modifies or resets the current station address of a network\r
+ interface, if supported. If Reset is TRUE, then the current station address is\r
+ set to the network interface's permanent address. If Reset is FALSE, and the\r
+ network interface allows its station address to be modified, then the current\r
+ station address is changed to the address specified by New. If the network\r
+ interface does not allow its station address to be modified, then\r
+ EFI_INVALID_PARAMETER will be returned. If the station address is successfully\r
+ updated on the network interface, EFI_SUCCESS will be returned. If the driver\r
+ has not been initialized, EFI_DEVICE_ERROR will be returned.\r
+\r
+ @param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.\r
+ @param Reset Flag used to reset the station address to the network interface's\r
+ permanent address.\r
+ @param New New station address to be used for the network interface.\r
+\r
+\r
+ @retval EFI_SUCCESS The network interface's station address was updated.\r
+ @retval EFI_NOT_STARTED The Simple Network Protocol interface has not been\r
+ started by calling Start().\r
+ @retval EFI_INVALID_PARAMETER The New station address was not accepted by the NIC.\r
+ @retval EFI_INVALID_PARAMETER Reset is FALSE and New is NULL.\r
+ @retval EFI_DEVICE_ERROR The Simple Network Protocol interface has not\r
+ been initialized by calling Initialize().\r
+ @retval EFI_DEVICE_ERROR An error occurred attempting to set the new\r
+ station address.\r
+ @retval EFI_UNSUPPORTED The NIC does not support changing the network\r
+ interface's station address.\r