[edk2-devel] [PATCH] EmulatorPkg/WinHost: Enable network support.

Nickle Wang posted 1 patch 4 years ago
Failed in applying to current master (apply log)
There is a newer version of this series
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
[edk2-devel] [PATCH] EmulatorPkg/WinHost: Enable network support.
Posted by Nickle Wang 4 years ago
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 <nickle.wang@hpe.com>
Signed-off-by: Derek Lin <derek.lin2@hpe.com>
---
 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.<BR>
 # Portions copyright (c) 2011, Apple Inc. All rights reserved.
+# (C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
 #
 #    SPDX-License-Identifier: BSD-2-Clause-Patent
 #
@@ -95,6 +96,7 @@
   gEmulatorPkgTokenSpaceGuid.PcdEmuFileSystem|L"."|VOID*|0x00001004
   gEmulatorPkgTokenSpaceGuid.PcdEmuSerialPort|L"/dev/ttyS0"|VOID*|0x00001002
   gEmulatorPkgTokenSpaceGuid.PcdEmuNetworkInterface|L"en0"|VOID*|0x0000100d
+  gEmulatorPkgTokenSpaceGuid.PcdEmuActiveNetworkInterfaceIndex|0x0|UINT8|0x0000101d
 
   gEmulatorPkgTokenSpaceGuid.PcdEmuCpuModel|L"Intel(R) Processor Model"|VOID*|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.
 
 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
-(C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>
+(C) Copyright 2016-2020 Hewlett Packard Enterprise Development LP<BR>
 SPDX-License-Identifier: BSD-2-Clause-Patent
 **/
 
@@ -443,6 +443,7 @@ Returns:
   AddThunkProtocol (&mWinNtWndThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuGop), TRUE);
   AddThunkProtocol (&mWinNtFileSystemThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuFileSystem), TRUE);
   AddThunkProtocol (&mWinNtBlockIoThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuVirtualDisk), TRUE);
+  AddThunkProtocol (&mWinNtSnpThunkIo, (CHAR16 *)PcdGetPtr (PcdEmuNetworkInterface), TRUE);
 
   //
   // 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
 
 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
 SPDX-License-Identifier: BSD-2-Clause-Patent
 
 
@@ -29,6 +30,7 @@ Abstract:
 
 #include <Protocol/EmuBlockIo.h>
 #include <Protocol/BlockIo.h>
+#include <Protocol/EmuSnp.h>
 
 #include <Library/BaseLib.h>
 #include <Library/PeCoffLib.h>
@@ -41,6 +43,7 @@ Abstract:
 #include <Library/BaseMemoryLib.h>
 #include <Library/PeiServicesLib.h>
 #include <Library/PeCoffExtraActionLib.h>
+#include <Library/NetLib.h>
 
 
 #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/WinHost.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 initialization finished.
 # Copyright (c) 2008 - 2019, Intel Corporation. All rights reserved.<BR>
 # Portions copyright (c) 2008 - 2011, Apple Inc. All rights reserved.<BR>
+# (C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
 #
 #  SPDX-License-Identifier: BSD-2-Clause-Patent
 #
@@ -33,11 +34,13 @@
   WinThunk.c
   WinHost.h
   WinHost.c
+  WinPacketFilter.c
   WinInclude.h
 
 [Packages]
   MdePkg/MdePkg.dec
   MdeModulePkg/MdeModulePkg.dec
+  NetworkPkg/NetworkPkg.dec
   EmulatorPkg/EmulatorPkg.dec
 
 [LibraryClasses]
@@ -61,6 +64,7 @@
   gEmuGraphicsWindowProtocolGuid
   gEmuBlockIoProtocolGuid
   gEfiSimpleFileSystemProtocolGuid
+  gEmuSnpProtocolGuid
 
 [Guids]
   gEfiFileSystemVolumeLabelInfoIdGuid           # SOMETIMES_CONSUMED
@@ -78,6 +82,8 @@
   gEmulatorPkgTokenSpaceGuid.PcdEmuGop|L"GOP Window"
   gEmulatorPkgTokenSpaceGuid.PcdEmuFileSystem
   gEmulatorPkgTokenSpaceGuid.PcdPeiServicesTablePage
+  gEmulatorPkgTokenSpaceGuid.PcdEmuNetworkInterface|L"eth0"
+  gEmulatorPkgTokenSpaceGuid.PcdEmuActiveNetworkInterfaceIndex
 
 [BuildOptions]
   MSFT:*_*_*_DLINK_FLAGS            == /out:"$(BIN_DIR)\$(BASE_NAME).exe" /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.<BR>
+Portions copyright (c) 2011, Apple Inc. All rights reserved.
+(C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
+
+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_SIGNATURE)
+
+
+/**
+  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 unsupported value.
+
+**/
+EFI_STATUS
+WinNtSnpCreateMapping (
+  IN     EMU_SNP_PROTOCOL         *This,
+  IN     EFI_SIMPLE_NETWORK_MODE  *Mode
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This);
+
+  Private->Mode = Mode;
+
+  //
+  // Set the broadcast address.
+  //
+  CopyMem (&Mode->BroadcastAddress, &Private->Instance.Mode.BroadcastAddress, 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.PermanentAddress, 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 started state.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpStart (
+  IN EMU_SNP_PROTOCOL  *This
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = 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 = 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 stopped state.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpStop (
+  IN EMU_SNP_PROTOCOL  *This
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = 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 = 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 buffer space
+                            that the driver should allocate for the network interface.
+                            Some network interfaces will not be able to use 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 buffer space
+                            that the driver should allocate for the network interface.
+                            Some network interfaces will not be able to use 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 transmit and
+                                receive buffers.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpInitialize (
+  IN EMU_SNP_PROTOCOL                    *This,
+  IN UINTN                               ExtraRxBufferSize  OPTIONAL,
+  IN UINTN                               ExtraTxBufferSize  OPTIONAL
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = 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 = 0;
+  Private->Mode->ReceiveFilterSetting = 0;
+  ZeroMem (Private->Mode->MCastFilter, sizeof (Private->Mode->MCastFilter));
+
+  Private->Mode->State = 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 device
+                               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 unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpReset (
+  IN EMU_SNP_PROTOCOL   *This,
+  IN BOOLEAN            ExtendedVerification
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = 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 unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpShutdown (
+  IN EMU_SNP_PROTOCOL  *This
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = 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 = EfiSimpleNetworkStarted;
+
+  Private->Mode->ReceiveFilterSetting = 0;
+  Private->Mode->MCastFilterCount = 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 multicast receive
+                           filters on the network interface to their default 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 filter 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 updated.
+  @retval EFI_NOT_STARTED       The network interface has not been started.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpReceiveFilters (
+  IN EMU_SNP_PROTOCOL                             *This,
+  IN UINT32                                       Enable,
+  IN UINT32                                       Disable,
+  IN BOOLEAN                                      ResetMCastFilter,
+  IN UINTN                                        MCastFilterCnt     OPTIONAL,
+  IN EFI_MAC_ADDRESS                              *MCastFilter OPTIONAL
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+  INT32                 ReturnValue;
+
+  Private = WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This);
+
+  ReturnValue = Private->NtNetUtilityTable.SetReceiveFilter (
+                                                Private->Instance.InterfaceInfo.InterfaceIndex,
+                                                Enable,
+                                                (UINT32)MCastFilterCnt,
+                                                MCastFilter
+                                                );
+
+  if (ReturnValue <= 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 interfaces
+                permanent address.
+  @param  New   The new station address to be used for the network interface.
+
+  @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 unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpStationAddress (
+  IN EMU_SNP_PROTOCOL            *This,
+  IN BOOLEAN                     Reset,
+  IN EFI_MAC_ADDRESS             *New OPTIONAL
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = 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 network interface.
+  @param  StatisticsSize  On input the size, in bytes, of StatisticsTable. On
+                          output the size, in bytes, of the resulting table of
+                          statistics.
+  @param  StatisticsTable A pointer to the EFI_NETWORK_STATISTICS structure that
+                          contains the statistics.
+
+  @retval EFI_SUCCESS           The statistics were collected from the network interface.
+  @retval EFI_NOT_STARTED       The network interface has not been started.
+  @retval EFI_BUFFER_TOO_SMALL  The Statistics buffer was too small. The current buffer
+                                size needed to hold the statistics is returned in
+                                StatisticsSize.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network 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 = 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 multicast
+               HW MAC address.
+  @param  MAC  The multicast HW MAC address that is to be generated from IP.
+
+  @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 current buffer
+                                size needed to hold the statistics is returned in
+                                StatisticsSize.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network 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 = 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 NvRamAccessSize and
+                     less than NvRamSize.
+  @param  BufferSize The number of bytes to read or write from the NVRAM device.
+                     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 unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network 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 = WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This);
+
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Reads the current interrupt status and recycled transmit buffer status from
+  a network interface.
+
+  @param  This            The protocol instance pointer.
+  @param  InterruptStatus A pointer to the bit mask of the currently active interrupts
+                          If this is NULL, the interrupt status will not be read from
+                          the device. If this is not NULL, the interrupt status will
+                          be read from the device. When the  interrupt status is read,
+                          it will also be cleared. Clearing the transmit  interrupt
+                          does not empty the recycled transmit buffer array.
+  @param  TxBuf           Recycled transmit buffer address. The network interface will
+                          not transmit if its internal recycled transmit buffer array
+                          is full. Reading the transmit buffer does not clear the
+                          transmit interrupt. If this is NULL, then the transmit buffer
+                          status will not be read. If there are no transmit buffers to
+                          recycle and TxBuf is not NULL, * TxBuf will be set to NULL.
+
+  @retval EFI_SUCCESS           The status of the network interface was retrieved.
+  @retval EFI_NOT_STARTED       The network interface has not been started.
+  @retval EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network interface.
+
+**/
+EFI_STATUS
+WinNtSnpGetStatus (
+  IN EMU_SNP_PROTOCOL                     *This,
+  OUT UINT32                              *InterruptStatus OPTIONAL,
+  OUT VOID                                **TxBuf OPTIONAL
+  )
+{
+  WIN_NT_SNP_PRIVATE    *Private;
+
+  Private = WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This);
+
+  if (TxBuf != NULL) {
+    if (Private->Instance.RecycledTxBufCount != 0) {
+      Private->Instance.RecycledTxBufCount --;
+      *((UINT8 **) TxBuf)    = (UINT8 *) (UINTN)Private->Instance.RecycledTxBuf[Private->Instance.RecycledTxBufCount];
+    } else {
+      *((UINT8 **) TxBuf)    = NULL;
+    }
+  }
+
+  if (InterruptStatus != NULL) {
+    *InterruptStatus = 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, then 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 header and
+                     data) to be transmitted through the network interface.
+  @param  Buffer     A pointer to the packet (media header followed by data) to be
+                     transmitted. This parameter cannot be NULL. If HeaderSize is zero,
+                     then the media header in Buffer must already be filled in by the
+                     caller. If HeaderSize is non-zero, then the media header will be
+                     filled in by the Transmit() function.
+  @param  SrcAddr    The source HW MAC address. If HeaderSize is zero, then 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, then this
+                     parameter is ignored. See RFC 1700, section "Ether Types", for
+                     examples.
+
+  @retval EFI_SUCCESS           The packet was placed on the transmit queue.
+  @retval EFI_NOT_STARTED       The network interface has not been started.
+  @retval EFI_NOT_READY         The network interface is too busy to accept 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 unsupported value.
+  @retval EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval EFI_UNSUPPORTED       This function is not supported by the network 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 = WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This);
+
+  if ((HeaderSize != 0) && (SrcAddr == NULL)) {
+    SrcAddr = &Private->Instance.Mode.CurrentAddress;
+  }
+
+  ReturnValue = Private->NtNetUtilityTable.Transmit (
+                                                Private->Instance.InterfaceInfo.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) >= SNP_MAX_TX_BUFFER_NUM) {
+      return EFI_NOT_READY;
+    }
+
+    if (Private->Instance.RecycledTxBufCount < Private->Instance.MaxRecycledTxBuf) {
+      Private->Instance.RecycledTxBuf[Private->Instance.RecycledTxBufCount] = (UINT64) Buffer;
+      Private->Instance.RecycledTxBufCount ++;
+    } else {
+      Tmp = malloc (sizeof (UINT64) * (Private->Instance.MaxRecycledTxBuf + SNP_TX_BUFFER_INCREASEMENT));
+      if (Tmp == NULL) {
+        return EFI_DEVICE_ERROR;
+      }
+      CopyMem (Tmp, Private->Instance.RecycledTxBuf, sizeof (UINT64) * Private->Instance.RecycledTxBufCount);
+      free (Private->Instance.RecycledTxBuf);
+      Private->Instance.RecycledTxBuf    =  Tmp;
+      Private->Instance.MaxRecycledTxBuf += 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 the 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 media 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, then 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, and BufferSize has
+                                 been updated to the number of bytes received.
+  @retval  EFI_NOT_STARTED       The network interface has not been started.
+  @retval  EFI_NOT_READY         The network interface is too busy to accept 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 unsupported value.
+  @retval  EFI_DEVICE_ERROR      The command could not be sent to the network interface.
+  @retval  EFI_UNSUPPORTED       This function is not supported by the network 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 = WIN_NT_SNP_PRIVATE_DATA_FROM_THIS (This);
+
+  BufSize     = *BufferSize;
+
+  ASSERT (Private->NtNetUtilityTable.Receive != NULL);
+
+  ReturnValue = Private->NtNetUtilityTable.Receive (
+                                                Private->Instance.InterfaceInfo.InterfaceIndex,
+                                                BufferSize,
+                                                Buffer
+                                                );
+
+  if (ReturnValue < 0) {
+    if (ReturnValue == -100) {
+      return EFI_BUFFER_TOO_SMALL;
+    }
+
+    return EFI_DEVICE_ERROR;
+  } else if (ReturnValue == 0) {
+    return EFI_NOT_READY;
+  }
+
+  if (HeaderSize != NULL) {
+    *HeaderSize = 14;
+  }
+
+  if (SrcAddr != NULL) {
+    ZeroMem (SrcAddr, sizeof (EFI_MAC_ADDRESS));
+    CopyMem (SrcAddr, ((UINT8 *) Buffer) + 6, 6);
+  }
+
+  if (DestAddr != NULL) {
+    ZeroMem (DestAddr, sizeof (EFI_MAC_ADDRESS));
+    CopyMem (DestAddr, ((UINT8 *) Buffer), 6);
+  }
+
+  if (Protocol != NULL) {
+    *Protocol = NTOHS (*((UINT16 *) (((UINT8 *) Buffer) + 12)));
+  }
+
+  return (*BufferSize <= 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 == NULL || NetInfo == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  ZeroMem (Instance, sizeof (WIN_NT_INSTANCE_DATA));
+
+  Instance->Signature = WIN_NT_INSTANCE_SIGNATURE;
+  Instance->RecycledTxBufCount = 0;
+  Instance->MaxRecycledTxBuf = 32;
+  Instance->Mode.State = EfiSimpleNetworkInitialized;
+  Instance->Mode.HwAddressSize = NET_ETHER_ADDR_LEN;
+  Instance->Mode.MediaHeaderSize = NET_ETHER_HEADER_SIZE;
+  Instance->Mode.MaxPacketSize = 1500;
+  Instance->Mode.MaxMCastFilterCount = MAX_MCAST_FILTER_CNT;
+  Instance->Mode.IfType = NET_IFTYPE_ETHERNET;
+  Instance->Mode.MediaPresentSupported = TRUE;
+  Instance->Mode.MediaPresent = TRUE;
+
+  //
+  // Allocate the RecycledTxBuf.
+  //
+  Instance->RecycledTxBuf = malloc (sizeof (UINT64) * Instance->MaxRecycledTxBuf);
+  if (Instance->RecycledTxBuf == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  //
+  //  Set the interface information.
+  //
+  CopyMem (&Instance->InterfaceInfo, NetInfo, sizeof (Instance->InterfaceInfo));
+
+
+  //
+  //  Set broadcast address
+  //
+  SetMem (&Instance->Mode.BroadcastAddress, sizeof (EFI_MAC_ADDRESS), 0xFF);
+
+  //
+  //  Copy Current/PermanentAddress MAC address
+  //
+  CopyMem (&Instance->Mode.CurrentAddress, &Instance->InterfaceInfo.MacAddr, sizeof(Instance->Mode.CurrentAddress));
+  CopyMem (&Instance->Mode.PermanentAddress, &Instance->InterfaceInfo.MacAddr, sizeof(Instance->Mode.PermanentAddress));
+
+  //
+  //  Since the fake SNP is based on a real NIC, to avoid conflict with the 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 == NULL) {
+      return EFI_INVALID_PARAMETER;
+  }
+
+  NetUtilityLibInitDone = FALSE;
+  InterfaceCount        = MAX_INTERFACE_INFO_NUMBER;
+  DllFileNameU          = NETWORK_LIBRARY_NAME_U;
+
+  //
+  //  Load network utility library
+  //
+  Private->NetworkLibraryHandle = LoadLibraryEx (DllFileNameU, NULL, 0);
+  if (NULL == Private->NetworkLibraryHandle) {
+    return EFI_NOT_FOUND;
+  }
+
+  Private->NtNetUtilityTable.Initialize = (NT_NET_INITIALIZE) GetProcAddress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_INITIALIZE);
+  if (NULL == Private->NtNetUtilityTable.Initialize) {
+    Status = EFI_NOT_FOUND;
+    goto ErrorReturn;
+  }
+
+  Private->NtNetUtilityTable.Finalize = (NT_NET_FINALIZE) GetProcAddress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_FINALIZE);
+  if (NULL == Private->NtNetUtilityTable.Finalize) {
+    Status = EFI_NOT_FOUND;
+    goto ErrorReturn;
+  }
+
+  Private->NtNetUtilityTable.SetReceiveFilter = (NT_NET_SET_RECEIVE_FILTER) GetProcAddress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_SET_RCV_FILTER);
+  if (NULL == Private->NtNetUtilityTable.SetReceiveFilter) {
+    Status = EFI_NOT_FOUND;
+    goto ErrorReturn;
+  }
+
+  Private->NtNetUtilityTable.Receive = (NT_NET_RECEIVE) GetProcAddress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_RECEIVE);
+  if (NULL == Private->NtNetUtilityTable.Receive) {
+    Status = EFI_NOT_FOUND;
+    goto ErrorReturn;
+  }
+
+  Private->NtNetUtilityTable.Transmit = (NT_NET_TRANSMIT) GetProcAddress (Private->NetworkLibraryHandle, NETWORK_LIBRARY_TRANSMIT);
+  if (NULL == Private->NtNetUtilityTable.Transmit) {
+    Status = EFI_NOT_FOUND;
+    goto ErrorReturn;
+  }
+
+  //
+  //  Initialize the network utility library
+  //  And enumerate the interfaces in emulator host
+  //
+  ReturnValue = Private->NtNetUtilityTable.Initialize (&InterfaceCount, &NetInterfaceInfoBuffer[0]);
+  if (ReturnValue <= 0) {
+    Status = EFI_DEVICE_ERROR;
+    goto ErrorReturn;
+  }
+
+  NetUtilityLibInitDone = TRUE;
+
+  if (InterfaceCount == 0) {
+    Status = EFI_NOT_FOUND;
+    goto ErrorReturn;
+  }
+
+  DEBUG ((EFI_D_INFO, "%a, total %d interface(s) found\n", __FUNCTION__, InterfaceCount));
+  //
+  // Active interface index is set to first interface if given instance does
+  // not exist.
+  //
+  ActiveInterfaceIndex = (ActiveInstance >= InterfaceCount ? DEFAULT_SELECTED_NIC_INDEX : ActiveInstance);
+
+  //
+  // Initialize instance
+  //
+  Status = WinNtInitializeInstanceData (&Private->Instance, &NetInterfaceInfoBuffer[ActiveInterfaceIndex]);
+  if (EFI_ERROR (Status)) {
+      goto ErrorReturn;
+  }
+
+  return EFI_SUCCESS;
+
+ErrorReturn:
+
+  if (Private->Instance.RecycledTxBuf != NULL) {
+      free (Private->Instance.RecycledTxBuf);
+  }
+
+  if (NetUtilityLibInitDone) {
+    if (Private->NtNetUtilityTable.Finalize != NULL) {
+      Private->NtNetUtilityTable.Finalize ();
+      Private->NtNetUtilityTable.Finalize = 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 == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (Private->Instance.RecycledTxBuf != NULL) {
+      free (Private->Instance.RecycledTxBuf);
+  }
+
+  if (Private->NtNetUtilityTable.Finalize != NULL) {
+    Private->NtNetUtilityTable.Finalize ();
+  }
+
+  FreeLibrary (Private->NetworkLibraryHandle);
+
+  return EFI_SUCCESS;
+}
+
+EMU_SNP_PROTOCOL mWinNtSnpProtocol = {
+  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 != NULL) {
+    return EFI_ALREADY_STARTED;
+  }
+
+  if (!CompareGuid (This->Protocol, &gEmuSnpProtocolGuid)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Private = malloc (sizeof (WIN_NT_SNP_PRIVATE));
+  if (Private == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Private->Signature = WIN_NT_SIMPLE_NETWORK_PRIVATE_SIGNATURE;
+  Private->Thunk     = This;
+  CopyMem (&Private->EmuSnp, &mWinNtSnpProtocol, sizeof (mWinNtSnpProtocol));
+
+  This->Interface = &Private->EmuSnp;
+  This->Private   = Private;
+
+  return WintNtInitializeNetUtilityData (Private, PcdGet8 (PcdEmuActiveNetworkInterfaceIndex));
+}
+
+/**
+  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 = This->Private;
+  WintNtReleaseNetUtilityData (Private);
+  free (Private);
+
+  return EFI_SUCCESS;
+}
+
+EMU_IO_THUNK_PROTOCOL mWinNtSnpThunkIo = {
+  &gEmuSnpProtocolGuid,
+  NULL,
+  NULL,
+  0,
+  WinNtSnpThunkOpen,
+  WinNtSnpThunkClose,
+  NULL
+};
-- 
2.20.1.windows.1


-=-=-=-=-=-=-=-=-=-=-=-
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]
-=-=-=-=-=-=-=-=-=-=-=-