Intel Extensible Firmware Interface - Manual (Page 614)

Extensible Firmware Interface Specification
15-8 12/01/02 Version 1.10
EFI_SIMPLE_NETWORK.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.