https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Siyuan Fu <siyuan.fu@intel.com>
		
			
				
	
	
		
			100 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			100 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
|   The Mac Connection2 Protocol adapter functions for WiFi Connection Manager.
 | |
| 
 | |
|   Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
 | |
| 
 | |
|   SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
| **/
 | |
| 
 | |
| #ifndef __EFI_WIFI_IMPL__
 | |
| #define __EFI_WIFI_IMPL__
 | |
| 
 | |
| /**
 | |
|   Start scan operation, and send out a token to collect available networks.
 | |
| 
 | |
|   @param[in]  Nic                 Pointer to the device data of the selected NIC.
 | |
| 
 | |
|   @retval EFI_SUCCESS             The operation is completed.
 | |
|   @retval EFI_ALREADY_STARTED     A former scan operation is already ongoing.
 | |
|   @retval EFI_INVALID_PARAMETER   One or more parameters are invalid.
 | |
|   @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.
 | |
|   @retval Other Errors            Return errors when getting networks from low layer.
 | |
| 
 | |
| **/
 | |
| EFI_STATUS
 | |
| WifiMgrStartScan (
 | |
|   IN      WIFI_MGR_DEVICE_DATA        *Nic
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   Get current link state from low layer.
 | |
| 
 | |
|   @param[in]   Nic                Pointer to the device data of the selected NIC.
 | |
|   @param[out]  LinkState          The pointer to buffer to retrieve link state.
 | |
| 
 | |
|   @retval EFI_SUCCESS             The operation is completed.
 | |
|   @retval EFI_INVALID_PARAMETER   One or more parameters are invalid.
 | |
|   @retval EFI_UNSUPPORTED         Adapter information protocol is not supported.
 | |
|   @retval Other Errors            Returned errors when retrieving link state from low layer.
 | |
| 
 | |
| **/
 | |
| EFI_STATUS
 | |
| WifiMgrGetLinkState (
 | |
|   IN    WIFI_MGR_DEVICE_DATA          *Nic,
 | |
|   OUT   EFI_ADAPTER_INFO_MEDIA_STATE  *LinkState
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   Start connect operation, and send out a token to connect to a target network.
 | |
| 
 | |
|   @param[in]  Nic                 Pointer to the device data of the selected NIC.
 | |
|   @param[in]  Profile             The target network to be connected.
 | |
| 
 | |
|   @retval EFI_SUCCESS             The operation is completed.
 | |
|   @retval EFI_ALREADY_STARTED     Already in "connected" state, need to perform a disconnect
 | |
|                                   operation first.
 | |
|   @retval EFI_INVALID_PARAMETER   One or more parameters are invalid.
 | |
|   @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.
 | |
|   @retval Other Errors            Return errors when connecting network on low layer.
 | |
| 
 | |
| **/
 | |
| EFI_STATUS
 | |
| WifiMgrConnectToNetwork (
 | |
|   IN    WIFI_MGR_DEVICE_DATA              *Nic,
 | |
|   IN    WIFI_MGR_NETWORK_PROFILE          *Profile
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   Start disconnect operation, and send out a token to disconnect from current connected
 | |
|   network.
 | |
| 
 | |
|   @param[in]  Nic                 Pointer to the device data of the selected NIC.
 | |
| 
 | |
|   @retval EFI_SUCCESS             The operation is completed.
 | |
|   @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.
 | |
|   @retval Other Errors            Return errors when disconnecting a network on low layer.
 | |
| 
 | |
| **/
 | |
| EFI_STATUS
 | |
| WifiMgrDisconnectToNetwork (
 | |
|   IN    WIFI_MGR_DEVICE_DATA              *Nic
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   The state machine of the connection manager, periodically check the state and
 | |
|   perform a corresponding operation.
 | |
| 
 | |
|   @param[in]  Event                   The timer event to be triggered.
 | |
|   @param[in]  Context                 The context of the Nic device data.
 | |
| 
 | |
| **/
 | |
| VOID
 | |
| EFIAPI
 | |
| WifiMgrOnTimerTick (
 | |
|   IN EFI_EVENT              Event,
 | |
|   IN VOID                   *Context
 | |
|   );
 | |
| 
 | |
| #endif
 |