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