From nobody Mon Apr 29 20:17:14 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+56465+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+56465+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=hpe.com ARC-Seal: i=1; a=rsa-sha256; t=1585277882; cv=none; d=zohomail.com; s=zohoarc; b=HUYP33mgJd/LNdqdd0Zs99GRl1F6Z3ELsCrTjR1UKSzSko6XD689QW0tq6Ev7pys48JVrZgA8BqzXxj1xruilDYfu9iOFMVkHifUnIHKj0iOavw2cShTnsTsTkHqQjbWNvcFITyy3Sg99JwU26VqouaDeY41kZoJzGsSqKVXrzg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1585277882; h=Content-Transfer-Encoding:Cc:Date:From:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Sender:Subject:To; bh=/waxTZM0b5MjyD2NoHSuZYQjIffL2rrFoHjqaXlVSSk=; b=AH/eTxgGc83bW6FfQO0OIPnMgMEkPgyESexReAUIfn3Z6+STS5S21HP5Tb9j4XrAI0Mvus74fgGX9CUlKyTS2p8W35jCm9wZDItScfvgim8AIRuV8sufmEJ3jQiseXnjX9KXYUmrBardNhX5BwSCQl5tv2QgD7EV6lfYOS30kFY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+56465+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1585277882025674.9487990619913; Thu, 26 Mar 2020 19:58:02 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id 4lhvYY1788612xBEahOOA5J7; Thu, 26 Mar 2020 19:58:01 -0700 X-Received: from mx0a-002e3701.pphosted.com (mx0a-002e3701.pphosted.com [148.163.147.86]) by mx.groups.io with SMTP id smtpd.web10.4845.1585277880693780196 for ; Thu, 26 Mar 2020 19:58:00 -0700 X-Received: from pps.filterd (m0134422.ppops.net [127.0.0.1]) by mx0b-002e3701.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id 02R2w0OX016871 for ; Fri, 27 Mar 2020 02:58:00 GMT X-Received: from g4t3426.houston.hpe.com (g4t3426.houston.hpe.com [15.241.140.75]) by mx0b-002e3701.pphosted.com with ESMTP id 3016cv8x43-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 27 Mar 2020 02:58:00 +0000 X-Received: from g4t3433.houston.hpecorp.net (g4t3433.houston.hpecorp.net [16.208.49.245]) by g4t3426.houston.hpe.com (Postfix) with ESMTP id 4B43873 for ; Fri, 27 Mar 2020 02:57:59 +0000 (UTC) X-Received: from WANGNICK4.asiapacific.hpqcorp.net (unknown [10.43.41.3]) by g4t3433.houston.hpecorp.net (Postfix) with ESMTP id 46D6148; Fri, 27 Mar 2020 02:57:57 +0000 (UTC) From: "Nickle Wang" To: devel@edk2.groups.io, nickle.wang@hpe.com Cc: Derek Lin Subject: [edk2-devel] [PATCH] EmulatorPkg/WinHost: Enable network support. Date: Fri, 27 Mar 2020 10:57:48 +0800 Message-Id: <20200327025749.10848-1-nickle.wang@hpe.com> MIME-Version: 1.0 X-HPE-SCL: -1 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,nickle.wang@hpe.com X-Gm-Message-State: m3vJE26kjfdoVKAyyxuh5M3nx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1585277881; bh=0VcmJANZe1KomFtBjZ0DypJ+kyW8vIBXbGT5xH1hwDY=; h=Cc:Date:From:Reply-To:Subject:To; b=RYokVwtvgxGVNp1kTF3eRaNB0e1VvvBa8jtFvTDwD3diP5w23jE1qwG8ra0plD+pDXt 1a8J18RGbSBd1WNzLFan6QDs4OWiQWPGXl8ipLGFs/DW/v/vprX5w5yUe4rX7eKJCYby9 7dfSYpT6NqKmNi6n0KMejA+EN1VrmD3YhxA= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Follow the implementation from Unix host to implement SNP EMU_IO_THUNK_PROTOCOL and EMU_SNP_PROTOCOL. The network IO driver is the same one as Nt32. Please refer to NETWORK-IO Subproject for network Io driver(SnpNt32Io.dll). Signed-off-by: Nickle Wang Signed-off-by: Derek Lin --- EmulatorPkg/EmulatorPkg.dec | 2 + EmulatorPkg/Win/Host/WinHost.c | 3 +- EmulatorPkg/Win/Host/WinHost.h | 5 + EmulatorPkg/Win/Host/WinHost.inf | 6 + EmulatorPkg/Win/Host/WinPacketFilter.c | 1128 ++++++++++++++++++++++++ 5 files changed, 1143 insertions(+), 1 deletion(-) create mode 100644 EmulatorPkg/Win/Host/WinPacketFilter.c diff --git a/EmulatorPkg/EmulatorPkg.dec b/EmulatorPkg/EmulatorPkg.dec index 99250d9fe5..9858f217b9 100644 --- a/EmulatorPkg/EmulatorPkg.dec +++ b/EmulatorPkg/EmulatorPkg.dec @@ -4,6 +4,7 @@ # # Copyright (c) 2008 - 2019, Intel Corporation. All rights reserved.
# Portions copyright (c) 2011, Apple Inc. All rights reserved. +# (C) Copyright 2020 Hewlett Packard Enterprise Development LP
# # SPDX-License-Identifier: BSD-2-Clause-Patent # @@ -95,6 +96,7 @@ gEmulatorPkgTokenSpaceGuid.PcdEmuFileSystem|L"."|VOID*|0x00001004 gEmulatorPkgTokenSpaceGuid.PcdEmuSerialPort|L"/dev/ttyS0"|VOID*|0x000010= 02 gEmulatorPkgTokenSpaceGuid.PcdEmuNetworkInterface|L"en0"|VOID*|0x0000100d + gEmulatorPkgTokenSpaceGuid.PcdEmuActiveNetworkInterfaceIndex|0x0|UINT8|0= x0000101d =20 gEmulatorPkgTokenSpaceGuid.PcdEmuCpuModel|L"Intel(R) Processor Model"|VO= ID*|0x00001007 gEmulatorPkgTokenSpaceGuid.PcdEmuCpuSpeed|L"3000"|VOID*|0x00001008 diff --git a/EmulatorPkg/Win/Host/WinHost.c b/EmulatorPkg/Win/Host/WinHost.c index cfee156b27..0838c56dde 100644 --- a/EmulatorPkg/Win/Host/WinHost.c +++ b/EmulatorPkg/Win/Host/WinHost.c @@ -9,7 +9,7 @@ allocate memory space with ReadWrite and Execute attribute. =20 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
-(C) Copyright 2016 Hewlett Packard Enterprise Development LP
+(C) Copyright 2016-2020 Hewlett Packard Enterprise Development LP
SPDX-License-Identifier: BSD-2-Clause-Patent **/ =20 @@ -443,6 +443,7 @@ Returns: AddThunkProtocol (&mWinNtWndThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuGop), TR= UE); AddThunkProtocol (&mWinNtFileSystemThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuF= ileSystem), TRUE); AddThunkProtocol (&mWinNtBlockIoThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuVirt= ualDisk), TRUE); + AddThunkProtocol (&mWinNtSnpThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuNetworkI= nterface), TRUE); =20 // // Allocate space for gSystemMemory Array diff --git a/EmulatorPkg/Win/Host/WinHost.h b/EmulatorPkg/Win/Host/WinHost.h index 0e52c003fc..b36fea254e 100644 --- a/EmulatorPkg/Win/Host/WinHost.h +++ b/EmulatorPkg/Win/Host/WinHost.h @@ -1,6 +1,7 @@ /**@file =20 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
+(C) Copyright 2020 Hewlett Packard Enterprise Development LP
SPDX-License-Identifier: BSD-2-Clause-Patent =20 =20 @@ -29,6 +30,7 @@ Abstract: =20 #include #include +#include =20 #include #include @@ -41,6 +43,7 @@ Abstract: #include #include #include +#include =20 =20 #define TEMPORARY_RAM_SIZE 0x20000 @@ -200,4 +203,6 @@ extern EMU_THUNK_PROTOCOL gEmuThunkProtocol; extern EMU_IO_THUNK_PROTOCOL mWinNtWndThunkIo; extern EMU_IO_THUNK_PROTOCOL mWinNtFileSystemThunkIo; extern EMU_IO_THUNK_PROTOCOL mWinNtBlockIoThunkIo; +extern EMU_IO_THUNK_PROTOCOL mWinNtSnpThunkIo; + #endif diff --git a/EmulatorPkg/Win/Host/WinHost.inf b/EmulatorPkg/Win/Host/WinHos= t.inf index e0b3ecb15b..07e816c1d4 100644 --- a/EmulatorPkg/Win/Host/WinHost.inf +++ b/EmulatorPkg/Win/Host/WinHost.inf @@ -4,6 +4,7 @@ # Main executable file of Win Emulator that loads Sec core after initializ= ation finished. # Copyright (c) 2008 - 2019, Intel Corporation. All rights reserved.
# Portions copyright (c) 2008 - 2011, Apple Inc. All rights reserved.
+# (C) Copyright 2020 Hewlett Packard Enterprise Development LP
# # SPDX-License-Identifier: BSD-2-Clause-Patent # @@ -33,11 +34,13 @@ WinThunk.c WinHost.h WinHost.c + WinPacketFilter.c WinInclude.h =20 [Packages] MdePkg/MdePkg.dec MdeModulePkg/MdeModulePkg.dec + NetworkPkg/NetworkPkg.dec EmulatorPkg/EmulatorPkg.dec =20 [LibraryClasses] @@ -61,6 +64,7 @@ gEmuGraphicsWindowProtocolGuid gEmuBlockIoProtocolGuid gEfiSimpleFileSystemProtocolGuid + gEmuSnpProtocolGuid =20 [Guids] gEfiFileSystemVolumeLabelInfoIdGuid # SOMETIMES_CONSUMED @@ -78,6 +82,8 @@ gEmulatorPkgTokenSpaceGuid.PcdEmuGop|L"GOP Window" gEmulatorPkgTokenSpaceGuid.PcdEmuFileSystem gEmulatorPkgTokenSpaceGuid.PcdPeiServicesTablePage + gEmulatorPkgTokenSpaceGuid.PcdEmuNetworkInterface|L"eth0" + gEmulatorPkgTokenSpaceGuid.PcdEmuActiveNetworkInterfaceIndex =20 [BuildOptions] MSFT:*_*_*_DLINK_FLAGS =3D=3D /out:"$(BIN_DIR)\$(BASE_NAME).e= xe" /base:0x10000000 /pdb:"$(BIN_DIR)\$(BASE_NAME).pdb" diff --git a/EmulatorPkg/Win/Host/WinPacketFilter.c b/EmulatorPkg/Win/Host/= WinPacketFilter.c new file mode 100644 index 0000000000..6a3eac50c7 --- /dev/null +++ b/EmulatorPkg/Win/Host/WinPacketFilter.c @@ -0,0 +1,1128 @@ +/**@file + Windows Packet Filter implementation of the EMU_SNP_PROTOCOL that allows = the + emulator to get on real networks. + +Copyright (c) 2004 - 2009, Intel Corporation. All rights reserved.
+Portions copyright (c) 2011, Apple Inc. All rights reserved. +(C) Copyright 2020 Hewlett Packard Enterprise Development LP
+ +SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ +#include "WinHost.h" + +#define NETWORK_LIBRARY_NAME_U L"SnpNt32Io.dll" +#define NETWORK_LIBRARY_INITIALIZE "SnpInitialize" +#define NETWORK_LIBRARY_FINALIZE "SnpFinalize" +#define NETWORK_LIBRARY_SET_RCV_FILTER "SnpSetReceiveFilter" +#define NETWORK_LIBRARY_RECEIVE "SnpReceive" +#define NETWORK_LIBRARY_TRANSMIT "SnpTransmit" + +#pragma pack(1) +typedef struct _NT_NET_INTERFACE_INFO { + UINT32 InterfaceIndex; + EFI_MAC_ADDRESS MacAddr; +} NT_NET_INTERFACE_INFO; +#pragma pack() + +#define NET_ETHER_HEADER_SIZE 14 +#define MAX_INTERFACE_INFO_NUMBER 16 +#define SNP_MAX_TX_BUFFER_NUM 65536 +#define SNP_TX_BUFFER_INCREASEMENT 32 +#define DEFAULT_SELECTED_NIC_INDEX 0 + +// +// Functions in Net Library +// +typedef +INT32 +(*NT_NET_INITIALIZE) ( + IN OUT UINT32 *InterfaceCount, + IN OUT NT_NET_INTERFACE_INFO * InterfaceInfoBuffer + ); + +typedef +INT32 +(*NT_NET_FINALIZE) ( + VOID + ); + +typedef +INT32 +(*NT_NET_SET_RECEIVE_FILTER) ( + IN UINT32 Index, + IN UINT32 EnableFilter, + IN UINT32 MCastFilterCnt, + IN EFI_MAC_ADDRESS * MCastFilter + ); + +typedef +INT32 +(*NT_NET_RECEIVE) ( + IN UINT32 Index, + IN OUT UINT32 *BufferSize, + OUT VOID *Buffer + ); + +typedef +INT32 +(*NT_NET_TRANSMIT) ( + IN UINT32 Index, + IN UINT32 HeaderSize, + IN UINT32 BufferSize, + IN VOID *Buffer, + IN EFI_MAC_ADDRESS * SrcAddr, + IN EFI_MAC_ADDRESS * DestAddr, + IN UINT16 *Protocol + ); + +typedef struct _NT_NET_UTILITY_TABLE { + NT_NET_INITIALIZE Initialize; + NT_NET_FINALIZE Finalize; + NT_NET_SET_RECEIVE_FILTER SetReceiveFilter; + NT_NET_RECEIVE Receive; + NT_NET_TRANSMIT Transmit; +} NT_NET_UTILITY_TABLE; + +// +// Instance data for each fake SNP instance +// +#define WIN_NT_INSTANCE_SIGNATURE SIGNATURE_32 ('N', 'T', 'I', 'S') + +typedef struct { + UINT32 Signature; + + // + // Array of the recycled transmit buffer address. + // + UINT64 *RecycledTxBuf; + + // + // Current number of recycled buffer pointers in RecycledTxBuf. + // + UINT32 RecycledTxBufCount; + + // + // The maximum number of recycled buffer pointers in RecycledTxBuf. + // + UINT32 MaxRecycledTxBuf; + EFI_SIMPLE_NETWORK_MODE Mode; + NT_NET_INTERFACE_INFO InterfaceInfo; +} WIN_NT_INSTANCE_DATA; + +// +// Instance data for each SNP private instance +// +#define WIN_NT_SIMPLE_NETWORK_PRIVATE_SIGNATURE SIGNATURE_32 ('N', 'T', 's= ', 'n') + +typedef struct { + UINTN Signature; + EMU_IO_THUNK_PROTOCOL *Thunk; + EMU_SNP_PROTOCOL EmuSnp; + EFI_SIMPLE_NETWORK_MODE *Mode; + HMODULE NetworkLibraryHandle; + NT_NET_UTILITY_TABLE NtNetUtilityTable; + WIN_NT_INSTANCE_DATA Instance; +} WIN_NT_SNP_PRIVATE; + +#define WIN_NT_SNP_PRIVATE_DATA_FROM_THIS(a) \ + CR(a, WIN_NT_SNP_PRIVATE, EmuSnp, WIN_NT_SIMPLE_NETWORK_PRIVATE_S= IGNATURE) + + +/** + Register storage for SNP Mode. + + @param This Protocol instance pointer. + @param Mode SimpleNetworkProtocol Mode structure passed into driver. + + @retval EFI_SUCCESS The network interface was started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + +**/ +EFI_STATUS +WinNtSnpCreateMapping ( + IN EMU_SNP_PROTOCOL *This, + IN EFI_SIMPLE_NETWORK_MODE *Mode + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + Private->Mode =3D Mode; + + // + // Set the broadcast address. + // + CopyMem (&Mode->BroadcastAddress, &Private->Instance.Mode.BroadcastAddre= ss, sizeof (EFI_MAC_ADDRESS)); + // + // Set the MAC address. + // + CopyMem (&Mode->CurrentAddress, &Private->Instance.Mode.CurrentAddress, = sizeof (EFI_MAC_ADDRESS)); + CopyMem (&Mode->PermanentAddress, &Private->Instance.Mode.PermanentAddre= ss, sizeof (EFI_MAC_ADDRESS)); + + return EFI_SUCCESS; +} + +/** + Changes the state of a network interface from "stopped" to "started". + + @param This Protocol instance pointer. + + @retval EFI_SUCCESS The network interface was started. + @retval EFI_ALREADY_STARTED The network interface is already in the st= arted state. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpStart ( + IN EMU_SNP_PROTOCOL *This + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + switch (Private->Mode->State) { + case EfiSimpleNetworkStopped: + break; + + case EfiSimpleNetworkStarted: + case EfiSimpleNetworkInitialized: + return EFI_ALREADY_STARTED; + break; + + default: + return EFI_DEVICE_ERROR; + break; + } + + Private->Mode->State =3D EfiSimpleNetworkStarted; + + return EFI_SUCCESS; +} + +/** + Changes the state of a network interface from "started" to "stopped". + + @param This Protocol instance pointer. + + @retval EFI_SUCCESS The network interface was stopped. + @retval EFI_ALREADY_STARTED The network interface is already in the st= opped state. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpStop ( + IN EMU_SNP_PROTOCOL *This + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + switch ( Private->Mode->State ) { + case EfiSimpleNetworkStarted: + break; + + case EfiSimpleNetworkStopped: + return EFI_NOT_STARTED; + break; + + default: + return EFI_DEVICE_ERROR; + break; + } + + Private->Mode->State =3D EfiSimpleNetworkStopped; + + return EFI_SUCCESS; +} + +/** + Resets a network adapter and allocates the transmit and receive buffers + required by the network interface; optionally, also requests allocation + of additional transmit and receive buffers. + + @param This The protocol instance pointer. + @param ExtraRxBufferSize The size, in bytes, of the extra receive buffe= r space + that the driver should allocate for the networ= k interface. + Some network interfaces will not be able to us= e the extra + buffer, and the caller will not know if it is = actually + being used. + @param ExtraTxBufferSize The size, in bytes, of the extra transmit buff= er space + that the driver should allocate for the networ= k interface. + Some network interfaces will not be able to us= e the extra + buffer, and the caller will not know if it is = actually + being used. + + @retval EFI_SUCCESS The network interface was initialized. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_OUT_OF_RESOURCES There was not enough memory for the transm= it and + receive buffers. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpInitialize ( + IN EMU_SNP_PROTOCOL *This, + IN UINTN ExtraRxBufferSize OPTIONAL, + IN UINTN ExtraTxBufferSize OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + switch ( Private->Mode->State ) { + case EfiSimpleNetworkStarted: + break; + + case EfiSimpleNetworkStopped: + return EFI_NOT_STARTED; + break; + + default: + return EFI_DEVICE_ERROR; + break; + } + + Private->Mode->MCastFilterCount =3D 0; + Private->Mode->ReceiveFilterSetting =3D 0; + ZeroMem (Private->Mode->MCastFilter, sizeof (Private->Mode->MCastFilter)= ); + + Private->Mode->State =3D EfiSimpleNetworkInitialized; + + return EFI_SUCCESS; +} + +/** + Resets a network adapter and re-initializes it with the parameters that = were + provided in the previous call to Initialize(). + + @param This The protocol instance pointer. + @param ExtendedVerification Indicates that the driver may perform a more + exhaustive verification operation of the de= vice + during reset. + + @retval EFI_SUCCESS The network interface was reset. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpReset ( + IN EMU_SNP_PROTOCOL *This, + IN BOOLEAN ExtendedVerification + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + switch ( Private->Mode->State ) { + case EfiSimpleNetworkInitialized: + break; + + case EfiSimpleNetworkStopped: + return EFI_NOT_STARTED; + break; + + default: + return EFI_DEVICE_ERROR; + break; + } + + return EFI_SUCCESS; +} + +/** + Resets a network adapter and leaves it in a state that is safe for + another driver to initialize. + + @param This Protocol instance pointer. + + @retval EFI_SUCCESS The network interface was shutdown. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpShutdown ( + IN EMU_SNP_PROTOCOL *This + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + switch ( Private->Mode->State ) { + case EfiSimpleNetworkInitialized: + break; + + case EfiSimpleNetworkStopped: + return EFI_NOT_STARTED; + break; + + default: + return EFI_DEVICE_ERROR; + break; + } + + Private->Mode->State =3D EfiSimpleNetworkStarted; + + Private->Mode->ReceiveFilterSetting =3D 0; + Private->Mode->MCastFilterCount =3D 0; + ZeroMem (Private->Mode->MCastFilter, sizeof (Private->Mode->MCastFilter)= ); + + return EFI_SUCCESS; +} + +/** + Manages the multicast receive filters of a network interface. + + @param This The protocol instance pointer. + @param Enable A bit mask of receive filters to enable on the = network interface. + @param Disable A bit mask of receive filters to disable on the= network interface. + @param ResetMCastFilter Set to TRUE to reset the contents of the multic= ast receive + filters on the network interface to their defau= lt values. + @param McastFilterCnt Number of multicast HW MAC addresses in the new + MCastFilter list. This value must be less than = or equal to + the MCastFilterCnt field of EMU_SNP_MODE. This + field is optional if ResetMCastFilter is TRUE. + @param MCastFilter A pointer to a list of new multicast receive fi= lter HW MAC + addresses. This list will replace any existing = multicast + HW MAC address list. This field is optional if + ResetMCastFilter is TRUE. + + @retval EFI_SUCCESS The multicast receive filter list was upda= ted. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpReceiveFilters ( + IN EMU_SNP_PROTOCOL *This, + IN UINT32 Enable, + IN UINT32 Disable, + IN BOOLEAN ResetMCastFilter, + IN UINTN MCastFilterCnt OPTIO= NAL, + IN EFI_MAC_ADDRESS *MCastFilter OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + INT32 ReturnValue; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + ReturnValue =3D Private->NtNetUtilityTable.SetReceiveFilter ( + Private->Instance.Interfac= eInfo.InterfaceIndex, + Enable, + (UINT32)MCastFilterCnt, + MCastFilter + ); + + if (ReturnValue <=3D 0) { + return EFI_DEVICE_ERROR; + } + + return EFI_SUCCESS; +} + +/** + Modifies or resets the current station address, if supported. + + @param This The protocol instance pointer. + @param Reset Flag used to reset the station address to the network inte= rfaces + permanent address. + @param New The new station address to be used for the network interfa= ce. + + @retval EFI_SUCCESS The network interfaces station address was= updated. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpStationAddress ( + IN EMU_SNP_PROTOCOL *This, + IN BOOLEAN Reset, + IN EFI_MAC_ADDRESS *New OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + return EFI_UNSUPPORTED; +} + +/** + Resets or collects the statistics on a network interface. + + @param This Protocol instance pointer. + @param Reset Set to TRUE to reset the statistics for the netw= ork interface. + @param StatisticsSize On input the size, in bytes, of StatisticsTable.= On + output the size, in bytes, of the resulting tabl= e of + statistics. + @param StatisticsTable A pointer to the EFI_NETWORK_STATISTICS structur= e that + contains the statistics. + + @retval EFI_SUCCESS The statistics were collected from the net= work interface. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_BUFFER_TOO_SMALL The Statistics buffer was too small. The c= urrent buffer + size needed to hold the statistics is retu= rned in + StatisticsSize. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpStatistics ( + IN EMU_SNP_PROTOCOL *This, + IN BOOLEAN Reset, + IN OUT UINTN *StatisticsSize OPTIONAL, + OUT EFI_NETWORK_STATISTICS *StatisticsTable OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + return EFI_UNSUPPORTED; +} + +/** + Converts a multicast IP address to a multicast HW MAC address. + + @param This The protocol instance pointer. + @param IPv6 Set to TRUE if the multicast IP address is IPv6 [RFC 2460].= Set + to FALSE if the multicast IP address is IPv4 [RFC 791]. + @param IP The multicast IP address that is to be converted to a multi= cast + HW MAC address. + @param MAC The multicast HW MAC address that is to be generated from I= P. + + @retval EFI_SUCCESS The multicast IP address was mapped to the= multicast + HW MAC address. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_BUFFER_TOO_SMALL The Statistics buffer was too small. The c= urrent buffer + size needed to hold the statistics is retu= rned in + StatisticsSize. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpMCastIpToMac ( + IN EMU_SNP_PROTOCOL *This, + IN BOOLEAN IPv6, + IN EFI_IP_ADDRESS *IP, + OUT EFI_MAC_ADDRESS *MAC + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + return EFI_UNSUPPORTED; +} + +/** + Performs read and write operations on the NVRAM device attached to a + network interface. + + @param This The protocol instance pointer. + @param ReadWrite TRUE for read operations, FALSE for write operations. + @param Offset Byte offset in the NVRAM device at which to start the= read or + write operation. This must be a multiple of NvRamAcce= ssSize and + less than NvRamSize. + @param BufferSize The number of bytes to read or write from the NVRAM d= evice. + This must also be a multiple of NvramAccessSize. + @param Buffer A pointer to the data buffer. + + @retval EFI_SUCCESS The NVRAM access was performed. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpNvData ( + IN EMU_SNP_PROTOCOL *This, + IN BOOLEAN ReadWrite, + IN UINTN Offset, + IN UINTN BufferSize, + IN OUT VOID *Buffer + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + return EFI_UNSUPPORTED; +} + +/** + Reads the current interrupt status and recycled transmit buffer status f= rom + a network interface. + + @param This The protocol instance pointer. + @param InterruptStatus A pointer to the bit mask of the currently activ= e interrupts + If this is NULL, the interrupt status will not b= e read from + the device. If this is not NULL, the interrupt s= tatus will + be read from the device. When the interrupt sta= tus is read, + it will also be cleared. Clearing the transmit = interrupt + does not empty the recycled transmit buffer arra= y. + @param TxBuf Recycled transmit buffer address. The network in= terface will + not transmit if its internal recycled transmit b= uffer array + is full. Reading the transmit buffer does not cl= ear the + transmit interrupt. If this is NULL, then the tr= ansmit buffer + status will not be read. If there are no transmi= t buffers to + recycle and TxBuf is not NULL, * TxBuf will be s= et to NULL. + + @retval EFI_SUCCESS The status of the network interface was re= trieved. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpGetStatus ( + IN EMU_SNP_PROTOCOL *This, + OUT UINT32 *InterruptStatus OPTIONAL, + OUT VOID **TxBuf OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + if (TxBuf !=3D NULL) { + if (Private->Instance.RecycledTxBufCount !=3D 0) { + Private->Instance.RecycledTxBufCount --; + *((UINT8 **) TxBuf) =3D (UINT8 *) (UINTN)Private->Instance.Recycl= edTxBuf[Private->Instance.RecycledTxBufCount]; + } else { + *((UINT8 **) TxBuf) =3D NULL; + } + } + + if (InterruptStatus !=3D NULL) { + *InterruptStatus =3D EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT; + } + + return EFI_SUCCESS; +} + +/** + Places a packet in the transmit queue of a network interface. + + @param This The protocol instance pointer. + @param HeaderSize The size, in bytes, of the media header to be filled = in by + the Transmit() function. If HeaderSize is non-zero, t= hen it + must be equal to This->Mode->MediaHeaderSize and the = DestAddr + and Protocol parameters must not be NULL. + @param BufferSize The size, in bytes, of the entire packet (media heade= r and + data) to be transmitted through the network interface. + @param Buffer A pointer to the packet (media header followed by dat= a) to be + transmitted. This parameter cannot be NULL. If Header= Size is zero, + then the media header in Buffer must already be fille= d in by the + caller. If HeaderSize is non-zero, then the media hea= der will be + filled in by the Transmit() function. + @param SrcAddr The source HW MAC address. If HeaderSize is zero, the= n this parameter + is ignored. If HeaderSize is non-zero and SrcAddr is = NULL, then + This->Mode->CurrentAddress is used for the source HW = MAC address. + @param DestAddr The destination HW MAC address. If HeaderSize is zero= , then this + parameter is ignored. + @param Protocol The type of header to build. If HeaderSize is zero, t= hen this + parameter is ignored. See RFC 1700, section "Ether Ty= pes", for + examples. + + @retval EFI_SUCCESS The packet was placed on the transmit queu= e. + @retval EFI_NOT_STARTED The network interface has not been started. + @retval EFI_NOT_READY The network interface is too busy to accep= t this transmit request. + @retval EFI_BUFFER_TOO_SMALL The BufferSize parameter is too small. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsup= ported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netwo= rk interface. + @retval EFI_UNSUPPORTED This function is not supported by the netw= ork interface. + +**/ +EFI_STATUS +WinNtSnpTransmit ( + IN EMU_SNP_PROTOCOL *This, + IN UINTN HeaderSize, + IN UINTN BufferSize, + IN VOID *Buffer, + IN EFI_MAC_ADDRESS *SrcAddr OPTIONAL, + IN EFI_MAC_ADDRESS *DestAddr OPTIONAL, + IN UINT16 *Protocol OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + INT32 ReturnValue; + UINT64 *Tmp; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + if ((HeaderSize !=3D 0) && (SrcAddr =3D=3D NULL)) { + SrcAddr =3D &Private->Instance.Mode.CurrentAddress; + } + + ReturnValue =3D Private->NtNetUtilityTable.Transmit ( + Private->Instance.Interfac= eInfo.InterfaceIndex, + (UINT32)HeaderSize, + (UINT32)BufferSize, + Buffer, + SrcAddr, + DestAddr, + Protocol + ); + + if (ReturnValue < 0) { + return EFI_DEVICE_ERROR; + } else { + if ((Private->Instance.MaxRecycledTxBuf + SNP_TX_BUFFER_INCREASEMENT) = >=3D SNP_MAX_TX_BUFFER_NUM) { + return EFI_NOT_READY; + } + + if (Private->Instance.RecycledTxBufCount < Private->Instance.MaxRecycl= edTxBuf) { + Private->Instance.RecycledTxBuf[Private->Instance.RecycledTxBufCount= ] =3D (UINT64) Buffer; + Private->Instance.RecycledTxBufCount ++; + } else { + Tmp =3D malloc (sizeof (UINT64) * (Private->Instance.MaxRecycledTxBu= f + SNP_TX_BUFFER_INCREASEMENT)); + if (Tmp =3D=3D NULL) { + return EFI_DEVICE_ERROR; + } + CopyMem (Tmp, Private->Instance.RecycledTxBuf, sizeof (UINT64) * Pri= vate->Instance.RecycledTxBufCount); + free (Private->Instance.RecycledTxBuf); + Private->Instance.RecycledTxBuf =3D Tmp; + Private->Instance.MaxRecycledTxBuf +=3D SNP_TX_BUFFER_INCREASEMENT; + } + } + + return EFI_SUCCESS; +} + +/** + Receives a packet from a network interface. + + @param This The protocol instance pointer. + @param HeaderSize The size, in bytes, of the media header received on t= he network + interface. If this parameter is NULL, then the media = header size + will not be returned. + @param BufferSize On entry, the size, in bytes, of Buffer. On exit, the= size, in + bytes, of the packet that was received on the network= interface. + @param Buffer A pointer to the data buffer to receive both the medi= a header and + the data. + @param SrcAddr The source HW MAC address. If this parameter is NULL,= the + HW MAC source address will not be extracted from the = media + header. + @param DestAddr The destination HW MAC address. If this parameter is = NULL, + the HW MAC destination address will not be extracted = from the + media header. + @param Protocol The media header type. If this parameter is NULL, the= n the + protocol will not be extracted from the media header.= See + RFC 1700 section "Ether Types" for examples. + + @retval EFI_SUCCESS The received data was stored in Buffer, a= nd BufferSize has + been updated to the number of bytes recei= ved. + @retval EFI_NOT_STARTED The network interface has not been starte= d. + @retval EFI_NOT_READY The network interface is too busy to acce= pt this transmit + request. + @retval EFI_BUFFER_TOO_SMALL The BufferSize parameter is too small. + @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsu= pported value. + @retval EFI_DEVICE_ERROR The command could not be sent to the netw= ork interface. + @retval EFI_UNSUPPORTED This function is not supported by the net= work interface. + +**/ +EFI_STATUS +WinNtSnpReceive ( + IN EMU_SNP_PROTOCOL *This, + OUT UINTN *HeaderSize OPTIONAL, + IN OUT UINTN *BufferSize, + OUT VOID *Buffer, + OUT EFI_MAC_ADDRESS *SrcAddr OPTIONAL, + OUT EFI_MAC_ADDRESS *DestAddr OPTIONAL, + OUT UINT16 *Protocol OPTIONAL + ) +{ + WIN_NT_SNP_PRIVATE *Private; + INT32 ReturnValue; + UINTN BufSize; + + Private =3D WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This); + + BufSize =3D *BufferSize; + + ASSERT (Private->NtNetUtilityTable.Receive !=3D NULL); + + ReturnValue =3D Private->NtNetUtilityTable.Receive ( + Private->Instance.Interfac= eInfo.InterfaceIndex, + BufferSize, + Buffer + ); + + if (ReturnValue < 0) { + if (ReturnValue =3D=3D -100) { + return EFI_BUFFER_TOO_SMALL; + } + + return EFI_DEVICE_ERROR; + } else if (ReturnValue =3D=3D 0) { + return EFI_NOT_READY; + } + + if (HeaderSize !=3D NULL) { + *HeaderSize =3D 14; + } + + if (SrcAddr !=3D NULL) { + ZeroMem (SrcAddr, sizeof (EFI_MAC_ADDRESS)); + CopyMem (SrcAddr, ((UINT8 *) Buffer) + 6, 6); + } + + if (DestAddr !=3D NULL) { + ZeroMem (DestAddr, sizeof (EFI_MAC_ADDRESS)); + CopyMem (DestAddr, ((UINT8 *) Buffer), 6); + } + + if (Protocol !=3D NULL) { + *Protocol =3D NTOHS (*((UINT16 *) (((UINT8 *) Buffer) + 12))); + } + + return (*BufferSize <=3D BufSize) ? EFI_SUCCESS : EFI_BUFFER_TOO_SMALL; +} + +/** + Initialize the snpnt32 driver instance. + + @param Instance Pointer to the instance context data. + @param NetInfo Pointer to the interface info. + + @retval EFI_SUCCESS The driver instance is initialized. + @retval other Initialization errors. + +**/ +EFI_STATUS +WinNtInitializeInstanceData ( + IN OUT WIN_NT_INSTANCE_DATA *Instance, + IN NT_NET_INTERFACE_INFO *NetInfo + ) +{ + if (Instance =3D=3D NULL || NetInfo =3D=3D NULL) { + return EFI_INVALID_PARAMETER; + } + + ZeroMem (Instance, sizeof (WIN_NT_INSTANCE_DATA)); + + Instance->Signature =3D WIN_NT_INSTANCE_SIGNATURE; + Instance->RecycledTxBufCount =3D 0; + Instance->MaxRecycledTxBuf =3D 32; + Instance->Mode.State =3D EfiSimpleNetworkInitialized; + Instance->Mode.HwAddressSize =3D NET_ETHER_ADDR_LEN; + Instance->Mode.MediaHeaderSize =3D NET_ETHER_HEADER_SIZE; + Instance->Mode.MaxPacketSize =3D 1500; + Instance->Mode.MaxMCastFilterCount =3D MAX_MCAST_FILTER_CNT; + Instance->Mode.IfType =3D NET_IFTYPE_ETHERNET; + Instance->Mode.MediaPresentSupported =3D TRUE; + Instance->Mode.MediaPresent =3D TRUE; + + // + // Allocate the RecycledTxBuf. + // + Instance->RecycledTxBuf =3D malloc (sizeof (UINT64) * Instance->MaxRecyc= ledTxBuf); + if (Instance->RecycledTxBuf =3D=3D NULL) { + return EFI_OUT_OF_RESOURCES; + } + + // + // Set the interface information. + // + CopyMem (&Instance->InterfaceInfo, NetInfo, sizeof (Instance->InterfaceI= nfo)); + + + // + // Set broadcast address + // + SetMem (&Instance->Mode.BroadcastAddress, sizeof (EFI_MAC_ADDRESS), 0xFF= ); + + // + // Copy Current/PermanentAddress MAC address + // + CopyMem (&Instance->Mode.CurrentAddress, &Instance->InterfaceInfo.MacAdd= r, sizeof(Instance->Mode.CurrentAddress)); + CopyMem (&Instance->Mode.PermanentAddress, &Instance->InterfaceInfo.MacA= ddr, sizeof(Instance->Mode.PermanentAddress)); + + // + // Since the fake SNP is based on a real NIC, to avoid conflict with th= e host + // NIC network stack, we use a different MAC address. + // So just change the last byte of the MAC address for the real NIC. + // + Instance->Mode.CurrentAddress.Addr[NET_ETHER_ADDR_LEN - 1]++; + + return EFI_SUCCESS; +} + +/** + Initialize the net utility data. + + @param This Pointer to the private data. + @param ActiveInstance The active network interface. + + @retval EFI_SUCCESS The global data is initialized. + @retval EFI_NOT_FOUND The required DLL is not found. + @retval EFI_DEVICE_ERROR Error initialize network utility library. + @retval other Other errors. + +**/ +EFI_STATUS +WintNtInitializeNetUtilityData ( + IN OUT WIN_NT_SNP_PRIVATE *Private, + IN UINT8 ActiveInstance + ) +{ + EFI_STATUS Status; + CHAR16 *DllFileNameU; + INT32 ReturnValue; + BOOLEAN NetUtilityLibInitDone; + NT_NET_INTERFACE_INFO NetInterfaceInfoBuffer[MAX_INTERFACE_INFO_NUMBER]; + UINT32 InterfaceCount; + UINT8 ActiveInterfaceIndex; + + if (Private =3D=3D NULL) { + return EFI_INVALID_PARAMETER; + } + + NetUtilityLibInitDone =3D FALSE; + InterfaceCount =3D MAX_INTERFACE_INFO_NUMBER; + DllFileNameU =3D NETWORK_LIBRARY_NAME_U; + + // + // Load network utility library + // + Private->NetworkLibraryHandle =3D LoadLibraryEx (DllFileNameU, NULL, 0); + if (NULL =3D=3D Private->NetworkLibraryHandle) { + return EFI_NOT_FOUND; + } + + Private->NtNetUtilityTable.Initialize =3D (NT_NET_INITIALIZE) GetProcAdd= ress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_INITIALIZE); + if (NULL =3D=3D Private->NtNetUtilityTable.Initialize) { + Status =3D EFI_NOT_FOUND; + goto ErrorReturn; + } + + Private->NtNetUtilityTable.Finalize =3D (NT_NET_FINALIZE) GetProcAddress= (Private->NetworkLibraryHandle, NETWORK_LIBRARY_FINALIZE); + if (NULL =3D=3D Private->NtNetUtilityTable.Finalize) { + Status =3D EFI_NOT_FOUND; + goto ErrorReturn; + } + + Private->NtNetUtilityTable.SetReceiveFilter =3D (NT_NET_SET_RECEIVE_FILT= ER) GetProcAddress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_SET_RCV_= FILTER); + if (NULL =3D=3D Private->NtNetUtilityTable.SetReceiveFilter) { + Status =3D EFI_NOT_FOUND; + goto ErrorReturn; + } + + Private->NtNetUtilityTable.Receive =3D (NT_NET_RECEIVE) GetProcAddress (= Private->NetworkLibraryHandle, NETWORK_LIBRARY_RECEIVE); + if (NULL =3D=3D Private->NtNetUtilityTable.Receive) { + Status =3D EFI_NOT_FOUND; + goto ErrorReturn; + } + + Private->NtNetUtilityTable.Transmit =3D (NT_NET_TRANSMIT) GetProcAddress= (Private->NetworkLibraryHandle, NETWORK_LIBRARY_TRANSMIT); + if (NULL =3D=3D Private->NtNetUtilityTable.Transmit) { + Status =3D EFI_NOT_FOUND; + goto ErrorReturn; + } + + // + // Initialize the network utility library + // And enumerate the interfaces in emulator host + // + ReturnValue =3D Private->NtNetUtilityTable.Initialize (&InterfaceCount, = &NetInterfaceInfoBuffer[0]); + if (ReturnValue <=3D 0) { + Status =3D EFI_DEVICE_ERROR; + goto ErrorReturn; + } + + NetUtilityLibInitDone =3D TRUE; + + if (InterfaceCount =3D=3D 0) { + Status =3D EFI_NOT_FOUND; + goto ErrorReturn; + } + + DEBUG ((EFI_D_INFO, "%a, total %d interface(s) found\n", __FUNCTION__, I= nterfaceCount)); + // + // Active interface index is set to first interface if given instance do= es + // not exist. + // + ActiveInterfaceIndex =3D (ActiveInstance >=3D InterfaceCount ? DEFAULT_S= ELECTED_NIC_INDEX : ActiveInstance); + + // + // Initialize instance + // + Status =3D WinNtInitializeInstanceData (&Private->Instance, &NetInterfac= eInfoBuffer[ActiveInterfaceIndex]); + if (EFI_ERROR (Status)) { + goto ErrorReturn; + } + + return EFI_SUCCESS; + +ErrorReturn: + + if (Private->Instance.RecycledTxBuf !=3D NULL) { + free (Private->Instance.RecycledTxBuf); + } + + if (NetUtilityLibInitDone) { + if (Private->NtNetUtilityTable.Finalize !=3D NULL) { + Private->NtNetUtilityTable.Finalize (); + Private->NtNetUtilityTable.Finalize =3D NULL; + } + } + + return Status; +} + +/** + Release the net utility data. + + @param This Pointer to the private data. + + @retval EFI_SUCCESS The global data is released. + @retval other Other errors. + +**/ +EFI_STATUS +WintNtReleaseNetUtilityData ( + IN OUT WIN_NT_SNP_PRIVATE *Private + ) +{ + if (Private =3D=3D NULL) { + return EFI_INVALID_PARAMETER; + } + + if (Private->Instance.RecycledTxBuf !=3D NULL) { + free (Private->Instance.RecycledTxBuf); + } + + if (Private->NtNetUtilityTable.Finalize !=3D NULL) { + Private->NtNetUtilityTable.Finalize (); + } + + FreeLibrary (Private->NetworkLibraryHandle); + + return EFI_SUCCESS; +} + +EMU_SNP_PROTOCOL mWinNtSnpProtocol =3D { + WinNtSnpCreateMapping, + WinNtSnpStart, + WinNtSnpStop, + WinNtSnpInitialize, + WinNtSnpReset, + WinNtSnpShutdown, + WinNtSnpReceiveFilters, + WinNtSnpStationAddress, + WinNtSnpStatistics, + WinNtSnpMCastIpToMac, + WinNtSnpNvData, + WinNtSnpGetStatus, + WinNtSnpTransmit, + WinNtSnpReceive +}; + +/** + Open SNP thunk protocol. + + @param This Pointer to the thunk protocol instance. + + @retval EFI_SUCCESS SNP thunk protocol is opened successfully. + @retval EFI_UNSUPPORTED This is not SNP thunk protocol. + @retval EFI_OUT_OF_RESOURCES Not enough memory. + @retval other Other errors. + +**/ +EFI_STATUS +WinNtSnpThunkOpen ( + IN EMU_IO_THUNK_PROTOCOL *This + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + if (This->Private !=3D NULL) { + return EFI_ALREADY_STARTED; + } + + if (!CompareGuid (This->Protocol, &gEmuSnpProtocolGuid)) { + return EFI_UNSUPPORTED; + } + + Private =3D malloc (sizeof (WIN_NT_SNP_PRIVATE)); + if (Private =3D=3D NULL) { + return EFI_OUT_OF_RESOURCES; + } + + Private->Signature =3D WIN_NT_SIMPLE_NETWORK_PRIVATE_SIGNATURE; + Private->Thunk =3D This; + CopyMem (&Private->EmuSnp, &mWinNtSnpProtocol, sizeof (mWinNtSnpProtocol= )); + + This->Interface =3D &Private->EmuSnp; + This->Private =3D Private; + + return WintNtInitializeNetUtilityData (Private, PcdGet8 (PcdEmuActiveNet= workInterfaceIndex)); +} + +/** + Close SNP thunk protocol. + + @param This Pointer to the thunk protocol instance. + + @retval EFI_SUCCESS SNP thunk protocol is closed successfully. + @retval EFI_UNSUPPORTED This is not SNP thunk protocol. + @retval other Other errors. + +**/ +EFI_STATUS +WinNtSnpThunkClose ( + IN EMU_IO_THUNK_PROTOCOL *This + ) +{ + WIN_NT_SNP_PRIVATE *Private; + + if (!CompareGuid (This->Protocol, &gEmuSnpProtocolGuid)) { + return EFI_UNSUPPORTED; + } + + Private =3D This->Private; + WintNtReleaseNetUtilityData (Private); + free (Private); + + return EFI_SUCCESS; +} + +EMU_IO_THUNK_PROTOCOL mWinNtSnpThunkIo =3D { + &gEmuSnpProtocolGuid, + NULL, + NULL, + 0, + WinNtSnpThunkOpen, + WinNtSnpThunkClose, + NULL +}; --=20 2.20.1.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#56465): https://edk2.groups.io/g/devel/message/56465 Mute This Topic: https://groups.io/mt/72580159/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-