beautypg.com

E.4.13 statistics, E.4.13.1 issuing the command, E.4.13.2 waiting for the command to execute – Intel Extensible Firmware Interface User Manual

Page 937

background image

32/64-Bit UNDI Specification

Version 1.10

12/01/02

E-71

E.4.13 Statistics

This command is used to read and clear the NIC traffic statistics. Before using this command check
to see if statistics is supported in the

!PXE.Implementation

flags.

E.4.13.1

Issuing the Command

To issue a Statistics command, create a CDB and fill it in as shown in the table below:

CDB Field

How to initialize the CDB structure for a Statistics command

OpCode

PXE_OPCODE_STATISTICS

OpFlags

Set as needed.

CPBsize

PXE_CPBSIZE_NOT_USED

DBsize

sizeof(PXE_DB_STATISTICS)

CPBaddr

PXE_CPBADDR_NOT_USED

DBaddr

Address of

PXE_DB_STATISTICS

structure.

StatCode

PXE_STATCODE_INITIALIZE

StatFlags

PXE_STATFLAGS_INITIALIZE

IFnum

A valid interface number from zero to

!PXE.IFcnt

.

Control

Set as needed.

OpFlags

To read the current statistics counters set the OpFlags field to:

PXE_OPFLAGS_STATISTICS_READ

To reset the current statistics counters set the OpFlags field to:

PXE_OPFLAGS_STATISTICS_RESET

E.4.13.2

Waiting for the Command to Execute

Monitor 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.

StatFlags Reason

COMMAND_COMPLETE

Command completed successfully. DB is written.

COMMAND_FAILED

Command failed. StatCode field contains error code.

COMMAND_QUEUED

Command has been queued.

INITIALIZE

Command has been not executed or queued.