MdeModulePkg: Clean up source files
1. Do not use tab characters 2. No trailing white space in one line 3. All files must end with CRLF Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Liming Gao <liming.gao@intel.com> Reviewed-by: Star Zeng <star.zeng@intel.com>
This commit is contained in:
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
UEFI Component Name(2) protocol implementation for SnpDxe driver.
|
||||
|
||||
Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -238,10 +238,10 @@ SimpleNetworkComponentNameGetDriverName (
|
||||
|
||||
@param Snp[in] A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL.
|
||||
|
||||
|
||||
|
||||
@retval EFI_SUCCESS Update the ControllerNameTable of this instance successfully.
|
||||
@retval EFI_INVALID_PARAMETER The input parameter is invalid.
|
||||
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
UpdateName (
|
||||
@@ -285,7 +285,7 @@ UpdateName (
|
||||
FreeUnicodeStringTable (gSimpleNetworkControllerNameTable);
|
||||
gSimpleNetworkControllerNameTable = NULL;
|
||||
}
|
||||
|
||||
|
||||
Status = AddUnicodeString2 (
|
||||
"eng",
|
||||
gSimpleNetworkComponentName.SupportedLanguages,
|
||||
@@ -296,7 +296,7 @@ UpdateName (
|
||||
if (EFI_ERROR (Status)) {
|
||||
return Status;
|
||||
}
|
||||
|
||||
|
||||
return AddUnicodeString2 (
|
||||
"en",
|
||||
gSimpleNetworkComponentName2.SupportedLanguages,
|
||||
@@ -317,8 +317,8 @@ UpdateName (
|
||||
and EFI_SUCCESS is returned. If the driver specified by This is not currently
|
||||
managing the controller specified by ControllerHandle and ChildHandle,
|
||||
then EFI_UNSUPPORTED is returned. If the driver specified by This does not
|
||||
support the language specified by Language, then EFI_UNSUPPORTED is returned.
|
||||
Currently not implemented.
|
||||
support the language specified by Language, then EFI_UNSUPPORTED is returned.
|
||||
Currently not implemented.
|
||||
|
||||
@param This[in] A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
|
||||
EFI_COMPONENT_NAME_PROTOCOL instance.
|
||||
@@ -387,7 +387,7 @@ SimpleNetworkComponentNameGetControllerName (
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
EFI_SIMPLE_NETWORK_PROTOCOL *Snp;
|
||||
|
||||
|
||||
if (ChildHandle != NULL) {
|
||||
return EFI_UNSUPPORTED;
|
||||
}
|
||||
@@ -404,9 +404,9 @@ SimpleNetworkComponentNameGetControllerName (
|
||||
return Status;
|
||||
}
|
||||
|
||||
//
|
||||
//
|
||||
// Retrieve an instance of a produced protocol from ControllerHandle
|
||||
//
|
||||
//
|
||||
Status = gBS->OpenProtocol (
|
||||
ControllerHandle,
|
||||
&gEfiSimpleNetworkProtocolGuid,
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of initializing a network adapter.
|
||||
Implementation of initializing a network adapter.
|
||||
|
||||
Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -19,9 +19,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
Call UNDI to initialize the interface.
|
||||
|
||||
@param Snp Pointer to snp driver structure.
|
||||
@param CableDetectFlag Do/don't detect the cable (depending on what
|
||||
@param CableDetectFlag Do/don't detect the cable (depending on what
|
||||
undi supports).
|
||||
|
||||
|
||||
@retval EFI_SUCCESS UNDI is initialized successfully.
|
||||
@retval EFI_DEVICE_ERROR UNDI could not be initialized.
|
||||
@retval Other Other errors as indicated.
|
||||
@@ -103,17 +103,17 @@ PxeInit (
|
||||
|
||||
//
|
||||
// There are two fields need to be checked here:
|
||||
// First is the upper two bits (14 & 15) in the CDB.StatFlags field. Until these bits change to report
|
||||
// First is the upper two bits (14 & 15) in the CDB.StatFlags field. Until these bits change to report
|
||||
// PXE_STATFLAGS_COMMAND_COMPLETE or PXE_STATFLAGS_COMMAND_FAILED, the command has not been executed by the UNDI.
|
||||
// Second is the CDB.StatCode field. After command execution completes, either successfully or not,
|
||||
// Second is the CDB.StatCode field. After command execution completes, either successfully or not,
|
||||
// the CDB.StatCode field contains the result of the command execution.
|
||||
//
|
||||
if ((((Snp->Cdb.StatFlags) & PXE_STATFLAGS_STATUS_MASK) == PXE_STATFLAGS_COMMAND_COMPLETE) &&
|
||||
(Snp->Cdb.StatCode == PXE_STATCODE_SUCCESS)) {
|
||||
//
|
||||
// If cable detect feature is enabled in CDB.OpFlags, check the CDB.StatFlags to see if there is an
|
||||
// active connection to this network device. If the no media StatFlag is set, the UNDI and network
|
||||
// device are still initialized.
|
||||
// If cable detect feature is enabled in CDB.OpFlags, check the CDB.StatFlags to see if there is an
|
||||
// active connection to this network device. If the no media StatFlag is set, the UNDI and network
|
||||
// device are still initialized.
|
||||
//
|
||||
if (CableDetectFlag == PXE_OPFLAGS_INITIALIZE_DETECT_CABLE) {
|
||||
if(((Snp->Cdb.StatFlags) & PXE_STATFLAGS_INITIALIZED_NO_MEDIA) != PXE_STATFLAGS_INITIALIZED_NO_MEDIA) {
|
||||
@@ -122,7 +122,7 @@ PxeInit (
|
||||
Snp->Mode.MediaPresent = FALSE;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
Snp->Mode.State = EfiSimpleNetworkInitialized;
|
||||
Status = EFI_SUCCESS;
|
||||
} else {
|
||||
@@ -151,8 +151,8 @@ PxeInit (
|
||||
|
||||
|
||||
/**
|
||||
Resets a network adapter and allocates the transmit and receive buffers
|
||||
required by the network interface; optionally, also requests allocation of
|
||||
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.
|
||||
|
||||
This function allocates the transmit and receive buffers required by the network
|
||||
@@ -164,8 +164,8 @@ PxeInit (
|
||||
|
||||
@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
|
||||
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.
|
||||
|
@@ -1,12 +1,12 @@
|
||||
/** @file
|
||||
Implementation of converting an multicast IP address to multicast HW MAC
|
||||
address.
|
||||
|
||||
Copyright (c) 2004 - 2007, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
Implementation of converting an multicast IP address to multicast HW MAC
|
||||
address.
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -23,11 +23,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@param IP Multicast IP address.
|
||||
@param MAC Pointer to hold the return MAC address.
|
||||
|
||||
@retval EFI_SUCCESS The multicast IP address was mapped to the
|
||||
@retval EFI_SUCCESS The multicast IP address was mapped to the
|
||||
multicast HW MAC address.
|
||||
@retval EFI_INVALID_PARAMETER Invalid UNDI command.
|
||||
@retval EFI_UNSUPPORTED Command is not supported by UNDI.
|
||||
@retval EFI_DEVICE_ERROR Fail to execute UNDI command.
|
||||
@retval EFI_INVALID_PARAMETER Invalid UNDI command.
|
||||
@retval EFI_UNSUPPORTED Command is not supported by UNDI.
|
||||
@retval EFI_DEVICE_ERROR Fail to execute UNDI command.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
@@ -103,29 +103,29 @@ PxeIp2Mac (
|
||||
|
||||
/**
|
||||
Converts a multicast IP address to a multicast HW MAC address.
|
||||
|
||||
This function converts a multicast IP address to a multicast HW MAC address
|
||||
|
||||
This function converts a multicast IP address to a multicast HW MAC address
|
||||
for all packet transactions. If the mapping is accepted, then EFI_SUCCESS will
|
||||
be returned.
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.
|
||||
@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
|
||||
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 Simple Network Protocol interface has not
|
||||
@retval EFI_NOT_STARTED The Simple Network Protocol interface has not
|
||||
been started by calling Start().
|
||||
@retval EFI_INVALID_PARAMETER IP is NULL.
|
||||
@retval EFI_INVALID_PARAMETER MAC is NULL.
|
||||
@retval EFI_INVALID_PARAMETER IP does not point to a valid IPv4 or IPv6
|
||||
@retval EFI_INVALID_PARAMETER IP does not point to a valid IPv4 or IPv6
|
||||
multicast address.
|
||||
@retval EFI_DEVICE_ERROR The Simple Network Protocol interface has not
|
||||
@retval EFI_DEVICE_ERROR The Simple Network Protocol interface has not
|
||||
been initialized by calling Initialize().
|
||||
@retval EFI_UNSUPPORTED IPv6 is TRUE and the implementation does not
|
||||
@retval EFI_UNSUPPORTED IPv6 is TRUE and the implementation does not
|
||||
support IPv6 multicast to MAC address conversion.
|
||||
|
||||
**/
|
||||
|
@@ -1,12 +1,12 @@
|
||||
/** @file
|
||||
Implementation of reading and writing operations on the NVRAM device
|
||||
attached to a network interface.
|
||||
|
||||
Copyright (c) 2004 - 2009, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
Implementation of reading and writing operations on the NVRAM device
|
||||
attached to a network interface.
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -97,51 +97,51 @@ PxeNvDataRead (
|
||||
|
||||
|
||||
/**
|
||||
Performs read and write operations on the NVRAM device attached to a network
|
||||
Performs read and write operations on the NVRAM device attached to a network
|
||||
interface.
|
||||
|
||||
This function performs read and write operations on the NVRAM device attached
|
||||
|
||||
This function performs read and write operations on the NVRAM device attached
|
||||
to a network interface. If ReadWrite is TRUE, a read operation is performed.
|
||||
If ReadWrite is FALSE, a write operation is performed. Offset specifies the
|
||||
byte offset at which to start either operation. Offset must be a multiple of
|
||||
NvRamAccessSize , and it must have a value between zero and NvRamSize.
|
||||
If ReadWrite is FALSE, a write operation is performed. Offset specifies the
|
||||
byte offset at which to start either operation. Offset must be a multiple of
|
||||
NvRamAccessSize , and it must have a value between zero and NvRamSize.
|
||||
BufferSize specifies the length of the read or write operation. BufferSize must
|
||||
also be a multiple of NvRamAccessSize, and Offset + BufferSize must not exceed
|
||||
NvRamSize.
|
||||
If any of the above conditions is not met, then EFI_INVALID_PARAMETER will be
|
||||
returned.
|
||||
If all the conditions are met and the operation is "read," the NVRAM device
|
||||
attached to the network interface will be read into Buffer and EFI_SUCCESS
|
||||
NvRamSize.
|
||||
If any of the above conditions is not met, then EFI_INVALID_PARAMETER will be
|
||||
returned.
|
||||
If all the conditions are met and the operation is "read," the NVRAM device
|
||||
attached to the network interface will be read into Buffer and EFI_SUCCESS
|
||||
will be returned. If this is a write operation, the contents of Buffer will be
|
||||
used to update the contents of the NVRAM device attached to the network
|
||||
used to update the contents of the NVRAM device attached to the network
|
||||
interface and EFI_SUCCESS will be returned.
|
||||
|
||||
|
||||
It does the basic checking on the input parameters and retrieves snp structure
|
||||
and then calls the read_nvdata() call which does the actual reading
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.
|
||||
@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. (See EFI_SIMPLE_NETWORK_MODE)
|
||||
@param BufferSize The number of bytes to read or write from the NVRAM device.
|
||||
@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. (See EFI_SIMPLE_NETWORK_MODE)
|
||||
@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 following conditions is TRUE:
|
||||
* The This parameter is NULL
|
||||
* The This parameter does not point to a valid
|
||||
* The This parameter is NULL
|
||||
* The This parameter does not point to a valid
|
||||
EFI_SIMPLE_NETWORK_PROTOCOL structure
|
||||
* The Offset parameter is not a multiple of
|
||||
* The Offset parameter is not a multiple of
|
||||
EFI_SIMPLE_NETWORK_MODE.NvRamAccessSize
|
||||
* The Offset parameter is not less than
|
||||
* The Offset parameter is not less than
|
||||
EFI_SIMPLE_NETWORK_MODE.NvRamSize
|
||||
* The BufferSize parameter is not a multiple of
|
||||
* The BufferSize parameter is not a multiple of
|
||||
EFI_SIMPLE_NETWORK_MODE.NvRamAccessSize
|
||||
* The Buffer parameter is NULL
|
||||
@retval EFI_DEVICE_ERROR The command could not be sent to the network
|
||||
@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.
|
||||
|
@@ -2,11 +2,11 @@
|
||||
Implementation of managing the multicast receive filters of a network
|
||||
interface.
|
||||
|
||||
Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed and made available under the
|
||||
terms and conditions of the BSD License which accompanies this distribution. The
|
||||
full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed and made available under the
|
||||
terms and conditions of the BSD License which accompanies this distribution. The
|
||||
full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -24,8 +24,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@param EnableFlags Bit mask for enabling the receive filters.
|
||||
@param MCastAddressCount Multicast address count for a new multicast address
|
||||
list.
|
||||
@param MCastAddressList List of new multicast addresses.
|
||||
|
||||
@param MCastAddressList List of new multicast addresses.
|
||||
|
||||
@retval EFI_SUCCESS The multicast receive filter list was updated.
|
||||
@retval EFI_INVALID_PARAMETER Invalid UNDI command.
|
||||
@retval EFI_UNSUPPORTED Command is not supported by UNDI.
|
||||
@@ -115,13 +115,13 @@ PxeRecvFilterEnable (
|
||||
|
||||
@param Snp Pointer to snp driver structure
|
||||
@param DisableFlags Bit mask for disabling the receive filters
|
||||
@param ResetMCastList Boolean flag to reset/delete the multicast filter
|
||||
@param ResetMCastList Boolean flag to reset/delete the multicast filter
|
||||
list.
|
||||
|
||||
@retval EFI_SUCCESS The multicast receive filter list was updated.
|
||||
@retval EFI_DEVICE_ERROR Fail to execute UNDI command.
|
||||
|
||||
**/
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
PxeRecvFilterDisable (
|
||||
SNP_DRIVER *Snp,
|
||||
@@ -194,8 +194,8 @@ PxeRecvFilterDisable (
|
||||
@param Snp Pointer to snp driver structure.
|
||||
|
||||
@retval EFI_SUCCESS The receive filter was read.
|
||||
@retval EFI_DEVICE_ERROR Fail to execute UNDI command.
|
||||
|
||||
@retval EFI_DEVICE_ERROR Fail to execute UNDI command.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
PxeRecvFilterRead (
|
||||
@@ -291,70 +291,70 @@ PxeRecvFilterRead (
|
||||
|
||||
/**
|
||||
Manages the multicast receive filters of a network interface.
|
||||
|
||||
This function is used enable and disable the hardware and software receive
|
||||
|
||||
This function is used enable and disable the hardware and software receive
|
||||
filters for the underlying network device.
|
||||
The receive filter change is broken down into three steps:
|
||||
* The filter mask bits that are set (ON) in the Enable parameter are added to
|
||||
the current receive filter settings.
|
||||
The receive filter change is broken down into three steps:
|
||||
* The filter mask bits that are set (ON) in the Enable parameter are added to
|
||||
the current receive filter settings.
|
||||
* The filter mask bits that are set (ON) in the Disable parameter are subtracted
|
||||
from the updated receive filter settings.
|
||||
* If the resulting receive filter setting is not supported by the hardware a
|
||||
more liberal setting is selected.
|
||||
If the same bits are set in the Enable and Disable parameters, then the bits
|
||||
If the same bits are set in the Enable and Disable parameters, then the bits
|
||||
in the Disable parameter takes precedence.
|
||||
If the ResetMCastFilter parameter is TRUE, then the multicast address list
|
||||
filter is disabled (irregardless of what other multicast bits are set in the
|
||||
Enable and Disable parameters). The SNP->Mode->MCastFilterCount field is set
|
||||
If the ResetMCastFilter parameter is TRUE, then the multicast address list
|
||||
filter is disabled (irregardless of what other multicast bits are set in the
|
||||
Enable and Disable parameters). The SNP->Mode->MCastFilterCount field is set
|
||||
to zero. The Snp->Mode->MCastFilter contents are undefined.
|
||||
After enabling or disabling receive filter settings, software should verify
|
||||
the new settings by checking the Snp->Mode->ReceiveFilterSettings,
|
||||
After enabling or disabling receive filter settings, software should verify
|
||||
the new settings by checking the Snp->Mode->ReceiveFilterSettings,
|
||||
Snp->Mode->MCastFilterCount and Snp->Mode->MCastFilter fields.
|
||||
Note: Some network drivers and/or devices will automatically promote receive
|
||||
Note: Some network drivers and/or devices will automatically promote receive
|
||||
filter settings if the requested setting can not be honored. For example, if
|
||||
a request for four multicast addresses is made and the underlying hardware
|
||||
only supports two multicast addresses the driver might set the promiscuous
|
||||
a request for four multicast addresses is made and the underlying hardware
|
||||
only supports two multicast addresses the driver might set the promiscuous
|
||||
or promiscuous multicast receive filters instead. The receiving software is
|
||||
responsible for discarding any extra packets that get through the hardware
|
||||
responsible for discarding any extra packets that get through the hardware
|
||||
receive filters.
|
||||
Note: Note: To disable all receive filter hardware, the network driver must
|
||||
Note: Note: To disable all receive filter hardware, the network driver must
|
||||
be Shutdown() and Stopped(). Calling ReceiveFilters() with Disable set to
|
||||
Snp->Mode->ReceiveFilterSettings will make it so no more packets are
|
||||
returned by the Receive() function, but the receive hardware may still be
|
||||
Snp->Mode->ReceiveFilterSettings will make it so no more packets are
|
||||
returned by the Receive() function, but the receive hardware may still be
|
||||
moving packets into system memory before inspecting and discarding them.
|
||||
Unexpected system errors, reboots and hangs can occur if an OS is loaded
|
||||
Unexpected system errors, reboots and hangs can occur if an OS is loaded
|
||||
and the network devices are not Shutdown() and Stopped().
|
||||
If ResetMCastFilter is TRUE, then the multicast receive filter list on the
|
||||
If ResetMCastFilter is TRUE, then the multicast receive filter list on the
|
||||
network interface will be reset to the default multicast receive filter list.
|
||||
If ResetMCastFilter is FALSE, and this network interface allows the multicast
|
||||
receive filter list to be modified, then the MCastFilterCnt and MCastFilter
|
||||
are used to update the current multicast receive filter list. The modified
|
||||
receive filter list settings can be found in the MCastFilter field of
|
||||
If ResetMCastFilter is FALSE, and this network interface allows the multicast
|
||||
receive filter list to be modified, then the MCastFilterCnt and MCastFilter
|
||||
are used to update the current multicast receive filter list. The modified
|
||||
receive filter list settings can be found in the MCastFilter field of
|
||||
EFI_SIMPLE_NETWORK_MODE. If the network interface does not allow the multicast
|
||||
receive filter list to be modified, then EFI_INVALID_PARAMETER will be returned.
|
||||
If the driver has not been initialized, EFI_DEVICE_ERROR will be returned.
|
||||
If the receive filter mask and multicast receive filter list have been
|
||||
If the receive filter mask and multicast receive filter list have been
|
||||
successfully updated on the network interface, EFI_SUCCESS will be returned.
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.
|
||||
@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. For backward compatibility with EFI 1.1
|
||||
interface. For backward compatibility with EFI 1.1
|
||||
platforms, the EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST bit
|
||||
must be set when the ResetMCastFilter parameter is TRUE.
|
||||
@param ResetMCastFilter Set to TRUE to reset the contents of the multicast
|
||||
receive filters on the network interface to their
|
||||
default values.
|
||||
@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 EFI_SIMPLE_NETWORK_MODE.
|
||||
list. This value must be less than or equal to the
|
||||
MCastFilterCnt field of EFI_SIMPLE_NETWORK_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
|
||||
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 following conditions is TRUE:
|
||||
@@ -363,9 +363,9 @@ PxeRecvFilterRead (
|
||||
in Snp->Mode->ReceiveFilterMask
|
||||
* There are bits set in Disable that are not set
|
||||
in Snp->Mode->ReceiveFilterMask
|
||||
* Multicast is being enabled (the
|
||||
EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST bit is
|
||||
set in Enable, it is not set in Disable, and
|
||||
* Multicast is being enabled (the
|
||||
EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST bit is
|
||||
set in Enable, it is not set in Disable, and
|
||||
ResetMCastFilter is FALSE) and MCastFilterCount
|
||||
is zero
|
||||
* Multicast is being enabled and MCastFilterCount
|
||||
@@ -377,7 +377,7 @@ PxeRecvFilterRead (
|
||||
@retval EFI_DEVICE_ERROR One or more of the following conditions is TRUE:
|
||||
* The network interface has been started but has
|
||||
not been initialized
|
||||
* An unexpected error was returned by the
|
||||
* An unexpected error was returned by the
|
||||
underlying network driver or device
|
||||
@retval EFI_UNSUPPORTED This function is not supported by the network
|
||||
interface.
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of resetting a network adapter.
|
||||
|
||||
Copyright (c) 2004 - 2007, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed and made available under the
|
||||
terms and conditions of the BSD License which accompanies this distribution. The
|
||||
full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed and made available under the
|
||||
terms and conditions of the BSD License which accompanies this distribution. The
|
||||
full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -70,16 +70,16 @@ PxeReset (
|
||||
provided in the previous call to Initialize().
|
||||
|
||||
This function resets a network adapter and reinitializes it with the parameters
|
||||
that were provided in the previous call to Initialize(). The transmit and
|
||||
that were provided in the previous call to Initialize(). The transmit and
|
||||
receive queues are emptied and all pending interrupts are cleared.
|
||||
Receive filters, the station address, the statistics, and the multicast-IP-to-HW
|
||||
MAC addresses are not reset by this call. If the network interface was
|
||||
successfully reset, then EFI_SUCCESS will be returned. If the driver has not
|
||||
Receive filters, the station address, the statistics, and the multicast-IP-to-HW
|
||||
MAC addresses are not reset by this call. If the network interface was
|
||||
successfully reset, then EFI_SUCCESS will be returned. If the driver has not
|
||||
been initialized, EFI_DEVICE_ERROR will be returned.
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.
|
||||
@param ExtendedVerification Indicates that the driver may perform a more
|
||||
exhaustive verification operation of the device
|
||||
@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.
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of shuting down a network adapter.
|
||||
|
||||
Copyright (c) 2004 - 2007, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -74,12 +74,12 @@ PxeShutdown (
|
||||
|
||||
|
||||
/**
|
||||
Resets a network adapter and leaves it in a state that is safe for another
|
||||
driver to initialize.
|
||||
|
||||
Resets a network adapter and leaves it in a state that is safe for another
|
||||
driver to initialize.
|
||||
|
||||
This function releases the memory buffers assigned in the Initialize() call.
|
||||
Pending transmits and receives are lost, and interrupts are cleared and disabled.
|
||||
After this call, only the Initialize() and Stop() calls may be used. If the
|
||||
After this call, only the Initialize() and Stop() calls may be used. If the
|
||||
network interface was successfully shutdown, then EFI_SUCCESS will be returned.
|
||||
If the driver has not been initialized, EFI_DEVICE_ERROR will be returned.
|
||||
|
||||
@@ -87,7 +87,7 @@ PxeShutdown (
|
||||
|
||||
@retval EFI_SUCCESS The network interface was shutdown.
|
||||
@retval EFI_NOT_STARTED The network interface has not been started.
|
||||
@retval EFI_INVALID_PARAMETER This parameter was NULL or did not point to a valid
|
||||
@retval EFI_INVALID_PARAMETER This parameter was NULL or did not point to a valid
|
||||
EFI_SIMPLE_NETWORK_PROTOCOL structure.
|
||||
@retval EFI_DEVICE_ERROR The command could not be sent to the network interface.
|
||||
|
||||
@@ -128,7 +128,7 @@ SnpUndi32Shutdown (
|
||||
Status = EFI_DEVICE_ERROR;
|
||||
goto ON_EXIT;
|
||||
}
|
||||
|
||||
|
||||
Status = PxeShutdown (Snp);
|
||||
|
||||
Snp->Mode.State = EfiSimpleNetworkStarted;
|
||||
|
@@ -1,7 +1,7 @@
|
||||
/** @file
|
||||
Implementation of driver entry point and driver binding protocol.
|
||||
|
||||
Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
@@ -275,7 +275,7 @@ SimpleNetworkDriverStart (
|
||||
EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *BarDesc;
|
||||
BOOLEAN FoundIoBar;
|
||||
BOOLEAN FoundMemoryBar;
|
||||
|
||||
|
||||
DEBUG ((EFI_D_NET, "\nSnpNotifyNetworkInterfaceIdentifier() "));
|
||||
|
||||
Status = gBS->OpenProtocol (
|
||||
@@ -411,7 +411,7 @@ SimpleNetworkDriverStart (
|
||||
}
|
||||
Snp->MaxRecycledTxBuf = SNP_TX_BUFFER_INCREASEMENT;
|
||||
Snp->RecycledTxBufCount = 0;
|
||||
|
||||
|
||||
if (Nii->Revision >= EFI_NETWORK_INTERFACE_IDENTIFIER_PROTOCOL_REVISION) {
|
||||
Snp->IfNum = Nii->IfNum;
|
||||
|
||||
|
@@ -1,14 +1,14 @@
|
||||
## @file
|
||||
# This module produces EFI SNP Protocol.
|
||||
#
|
||||
# This module produces Simple Network Protocol upon EFI Network Interface
|
||||
# This module produces Simple Network Protocol upon EFI Network Interface
|
||||
# Identifier Protocol, to provide a packet level interface to a network adapter.
|
||||
#
|
||||
# Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
|
||||
# This program and the accompanying materials are licensed
|
||||
# and made available under the terms and conditions of the BSD License which
|
||||
# accompanies this distribution. The full text of the license may be found at
|
||||
# http://opensource.org/licenses/bsd-license.php
|
||||
# Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
# This program and the accompanying materials are licensed
|
||||
# and made available under the terms and conditions of the BSD License which
|
||||
# accompanies this distribution. The full text of the license may be found at
|
||||
# http://opensource.org/licenses/bsd-license.php
|
||||
#
|
||||
# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -30,7 +30,7 @@
|
||||
#
|
||||
# VALID_ARCHITECTURES = IA32 X64 IPF EBC
|
||||
#
|
||||
# DRIVER_BINDING = mSimpleNetworkDriverBinding
|
||||
# DRIVER_BINDING = mSimpleNetworkDriverBinding
|
||||
# COMPONENT_NAME = gSimpleNetworkComponentName
|
||||
# COMPONENT_NAME2 = gSimpleNetworkComponentName2
|
||||
#
|
||||
|
@@ -4,13 +4,13 @@
|
||||
// This module produces Simple Network Protocol upon EFI Network Interface
|
||||
// Identifier Protocol, to provide a packet level interface to a network adapter.
|
||||
//
|
||||
// Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
|
||||
// Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
//
|
||||
// This program and the accompanying materials are licensed
|
||||
// and made available under the terms and conditions of the BSD License which
|
||||
// accompanies this distribution. The full text of the license may be found at
|
||||
// http://opensource.org/licenses/bsd-license.php
|
||||
//
|
||||
//
|
||||
// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
//
|
||||
|
@@ -1,7 +1,7 @@
|
||||
// /** @file
|
||||
// SnpDxe Localized Strings and Content
|
||||
//
|
||||
// Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
|
||||
// Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
//
|
||||
// This program and the accompanying materials are licensed
|
||||
// and made available under the terms and conditions of the BSD License which
|
||||
@@ -13,8 +13,8 @@
|
||||
//
|
||||
// **/
|
||||
|
||||
#string STR_PROPERTIES_MODULE_NAME
|
||||
#language en-US
|
||||
#string STR_PROPERTIES_MODULE_NAME
|
||||
#language en-US
|
||||
"SNP DXE Driver"
|
||||
|
||||
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of starting a network adapter.
|
||||
|
||||
Copyright (c) 2004 - 2007, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -22,7 +22,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
@retval EFI_SUCCESS UNDI is started successfully.
|
||||
@retval EFI_DEVICE_ERROR UNDI could not be started.
|
||||
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
PxeStart (
|
||||
@@ -100,7 +100,7 @@ PxeStart (
|
||||
|
||||
/**
|
||||
Change the state of a network interface from "stopped" to "started."
|
||||
|
||||
|
||||
This function starts a network interface. If the network interface successfully
|
||||
starts, then EFI_SUCCESS will be returned.
|
||||
|
||||
@@ -108,7 +108,7 @@ PxeStart (
|
||||
|
||||
@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 This parameter was NULL or did not point to a valid
|
||||
@retval EFI_INVALID_PARAMETER This parameter was NULL or did not point to a valid
|
||||
EFI_SIMPLE_NETWORK_PROTOCOL structure.
|
||||
@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.
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of reading the MAC address of a network adapter.
|
||||
|
||||
Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -16,11 +16,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
|
||||
/**
|
||||
Call UNDI to read the MAC address of the NIC and update the mode structure
|
||||
with the address.
|
||||
Call UNDI to read the MAC address of the NIC and update the mode structure
|
||||
with the address.
|
||||
|
||||
@param Snp Pointer to snp driver structure.
|
||||
|
||||
|
||||
@retval EFI_SUCCESS The MAC address of the NIC is read successfully.
|
||||
@retval EFI_DEVICE_ERROR Failed to read the MAC address of the NIC.
|
||||
|
||||
@@ -166,33 +166,33 @@ PxeSetStnAddr (
|
||||
|
||||
/**
|
||||
Modifies or resets the current station address, if supported.
|
||||
|
||||
This function modifies or resets the current station address of a network
|
||||
|
||||
This function modifies or resets the current station address of a network
|
||||
interface, if supported. If Reset is TRUE, then the current station address is
|
||||
set to the network interface's permanent address. If Reset is FALSE, and the
|
||||
network interface allows its station address to be modified, then the current
|
||||
station address is changed to the address specified by New. If the network
|
||||
interface does not allow its station address to be modified, then
|
||||
set to the network interface's permanent address. If Reset is FALSE, and the
|
||||
network interface allows its station address to be modified, then the current
|
||||
station address is changed to the address specified by New. If the network
|
||||
interface does not allow its station address to be modified, then
|
||||
EFI_INVALID_PARAMETER will be returned. If the station address is successfully
|
||||
updated on the network interface, EFI_SUCCESS will be returned. If the driver
|
||||
has not been initialized, EFI_DEVICE_ERROR will be returned.
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.
|
||||
@param Reset Flag used to reset the station address to the network interface's
|
||||
@param Reset Flag used to reset the station address to the network interface's
|
||||
permanent address.
|
||||
@param New New station address to be used for the network interface.
|
||||
|
||||
|
||||
@retval EFI_SUCCESS The network interface's station address was updated.
|
||||
@retval EFI_NOT_STARTED The Simple Network Protocol interface has not been
|
||||
@retval EFI_NOT_STARTED The Simple Network Protocol interface has not been
|
||||
started by calling Start().
|
||||
@retval EFI_INVALID_PARAMETER The New station address was not accepted by the NIC.
|
||||
@retval EFI_INVALID_PARAMETER Reset is FALSE and New is NULL.
|
||||
@retval EFI_DEVICE_ERROR The Simple Network Protocol interface has not
|
||||
@retval EFI_DEVICE_ERROR The Simple Network Protocol interface has not
|
||||
been initialized by calling Initialize().
|
||||
@retval EFI_DEVICE_ERROR An error occurred attempting to set the new
|
||||
@retval EFI_DEVICE_ERROR An error occurred attempting to set the new
|
||||
station address.
|
||||
@retval EFI_UNSUPPORTED The NIC does not support changing the network
|
||||
@retval EFI_UNSUPPORTED The NIC does not support changing the network
|
||||
interface's station address.
|
||||
|
||||
**/
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of stopping a network interface.
|
||||
|
||||
Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -19,7 +19,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
Call UNDI to stop the interface and changes the snp state.
|
||||
|
||||
@param Snp Pointer to snp driver structure
|
||||
|
||||
|
||||
@retval EFI_SUCCESS The network interface was stopped.
|
||||
@retval EFI_DEVICE_ERROR SNP is not initialized.
|
||||
|
||||
@@ -67,22 +67,22 @@ PxeStop (
|
||||
|
||||
/**
|
||||
Changes the state of a network interface from "started" to "stopped."
|
||||
|
||||
|
||||
This function stops a network interface. This call is only valid if the network
|
||||
interface is in the started state. If the network interface was successfully
|
||||
stopped, then EFI_SUCCESS will be returned.
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL
|
||||
instance.
|
||||
|
||||
|
||||
|
||||
|
||||
@retval EFI_SUCCESS The network interface was stopped.
|
||||
@retval EFI_NOT_STARTED The network interface has not been started.
|
||||
@retval EFI_INVALID_PARAMETER This parameter was NULL or did not point to a
|
||||
@retval EFI_INVALID_PARAMETER This parameter was NULL or did not point to a
|
||||
valid EFI_SIMPLE_NETWORK_PROTOCOL structure.
|
||||
@retval EFI_DEVICE_ERROR The command could not be sent to the network
|
||||
@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
|
||||
@retval EFI_UNSUPPORTED This function is not supported by the network
|
||||
interface.
|
||||
|
||||
**/
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Implementation of transmitting a packet.
|
||||
|
||||
Copyright (c) 2004 - 2017, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
@@ -221,45 +221,45 @@ PxeTransmit (
|
||||
|
||||
/**
|
||||
Places a packet in the transmit queue of a network interface.
|
||||
|
||||
|
||||
This function places the packet specified by Header and Buffer on the transmit
|
||||
queue. If HeaderSize is nonzero and HeaderSize is not equal to
|
||||
This->Mode->MediaHeaderSize, then EFI_INVALID_PARAMETER will be returned. If
|
||||
queue. If HeaderSize is nonzero and HeaderSize is not equal to
|
||||
This->Mode->MediaHeaderSize, then EFI_INVALID_PARAMETER will be returned. If
|
||||
BufferSize is less than This->Mode->MediaHeaderSize, then EFI_BUFFER_TOO_SMALL
|
||||
will be returned. If Buffer is NULL, then EFI_INVALID_PARAMETER will be
|
||||
will be returned. If Buffer is NULL, then EFI_INVALID_PARAMETER will be
|
||||
returned. If HeaderSize is nonzero and DestAddr or Protocol is NULL, then
|
||||
EFI_INVALID_PARAMETER will be returned. If the transmit engine of the network
|
||||
interface is busy, then EFI_NOT_READY will be returned. If this packet can be
|
||||
accepted by the transmit engine of the network interface, the packet contents
|
||||
specified by Buffer will be placed on the transmit queue of the network
|
||||
interface, and EFI_SUCCESS will be returned. GetStatus() can be used to
|
||||
determine when the packet has actually been transmitted. The contents of the
|
||||
Buffer must not be modified until the packet has actually been transmitted.
|
||||
interface is busy, then EFI_NOT_READY will be returned. If this packet can be
|
||||
accepted by the transmit engine of the network interface, the packet contents
|
||||
specified by Buffer will be placed on the transmit queue of the network
|
||||
interface, and EFI_SUCCESS will be returned. GetStatus() can be used to
|
||||
determine when the packet has actually been transmitted. The contents of the
|
||||
Buffer must not be modified until the packet has actually been transmitted.
|
||||
The Transmit() function performs nonblocking I/O. A caller who wants to perform
|
||||
blocking I/O, should call Transmit(), and then GetStatus() until the
|
||||
blocking I/O, should call Transmit(), and then GetStatus() until the
|
||||
transmitted buffer shows up in the recycled transmit buffer.
|
||||
If the driver has not been initialized, EFI_DEVICE_ERROR will be returned.
|
||||
|
||||
@param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.
|
||||
@param HeaderSize The size, in bytes, of the media header to be filled in by the
|
||||
@param HeaderSize The size, in bytes, of the media header to be filled in by the
|
||||
Transmit() function. If HeaderSize is nonzero, 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
|
||||
@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 nonzero, then the media
|
||||
in by the caller. If HeaderSize is nonzero, 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 nonzero and SrcAddr
|
||||
is NULL, then This->Mode->CurrentAddress is used for the
|
||||
@param SrcAddr The source HW MAC address. If HeaderSize is zero, then this
|
||||
parameter is ignored. If HeaderSize is nonzero 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
|
||||
@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,"
|
||||
@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.
|
||||
|
@@ -1,11 +1,11 @@
|
||||
/** @file
|
||||
Event handler to check for available packet.
|
||||
|
||||
Copyright (c) 2004 - 2008, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials are licensed
|
||||
and made available under the terms and conditions of the BSD License which
|
||||
accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
Reference in New Issue
Block a user