Description, Status codes returned – Intel Extensible Firmware Interface User Manual

Page 622

Advertising
background image

Extensible Firmware Interface Specification

15-16

12/01/02

Version 1.10

TxMulticastFrames

Number of valid multicast frames transmitted and not dropped.

TxCrcErrorFrames

Number of frames with CRC or alignment errors.

TxTotalBytes

Total number of bytes transmitted. Includes frames with errors
and dropped frames.

Collisions

Number of collisions detected on this subnet.

UnsupportedProtocol

Number of frames destined for unsupported protocol.

Description

This function resets or collects the statistics on a network interface. If the size of the statistics table
specified by

StatisticsSize

is not big enough for all the statistics that are collected by the

network interface, then a partial buffer of statistics is returned in

StatisticsTable

,

StatisticsSize

is set to the size required to collect all the available statistics, and

EFI_BUFFER_TOO_SMALL

is returned.

If

StatisticsSize

is big enough for all the statistics, then

StatisticsTable

will be filled,

StatisticsSize

will be set to the size of the returned

StatisticsTable

structure, and

EFI_SUCCESS

is returned. If the driver has not been initialized,

EFI_DEVICE_ERROR

will be

returned.

If

Reset

is

FALSE

, and both

StatisticsSize

and

StatisticsTable

are

NULL

, then no

operations will be performed, and

EFI_SUCCESS

will be returned.

If

Reset

is

TRUE

, then all of the supported statistics counters on this network interface will be

reset to zero.

Status Codes Returned

EFI_SUCCESS

The statistics were collected from the network interface.

EFI_NOT_STARTED

The network interface has not been started.

EFI_BUFFER_TOO_SMALL

The

Statistics

buffer was too small. The current buffer size

needed to hold the statistics is returned in

StatisticsSize

.

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.

Advertising