Intel Extensible Firmware Interface, Specification

Page: 302 / 494

Extensible Firmware Interface Specification
284 12/12/00 Version 1.02
15.1.3 EFI_SIMPLE_NETWO RK.Initialize()
Summary
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.
Prototype
EFI_STATUS
(EFIAPI *EFI_SIMPLE_NETWORK_INITIALIZE) (
IN EFI_SIMPLE_NETWORK *This,
IN UINTN ExtraRxBufferSize OPTIONAL ,
IN UINTN ExtraTxBufferSize OPTIONAL
);
Parameters
This
A pointer to the
EFI_SIMPLE_NETWORK
instance.
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.
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.
Description
This function allocates the transmit and receive buffers required by the network interface. If this
allocation fails, then
EFI_OUT_OF_RESOURCES
is returned. If the allocation succeeds and the
network interface is successfully initialized, then
EFI_SUCCESS
will be returned.
Status Codes Returned
EFI_SUCCESS The network interface was initialized.
EFI_NOT_STARTED The network interface has not been started.
EFI_OUT_OF_RESOURCES There was not enough memory for the transmit and receive buffers.
EFI_INVALID_PARAMETER One or more of the parameters has an unsupported value.
EFI_DEVICE_ERROR The command could not be sent to the network interface.
EFI_UNSUPPORTED This function is not supported by the network interface.