E.4.6 get config info, E.4.6.1 issuing the command, E.4.6.2 waiting for the command to execute – Intel Extensible Firmware Interface User Manual
Page 919
32/64-Bit UNDI Specification
Version 1.10
12/01/02
E-53
E.4.6
Get Config Info
This command is used to retrieve configuration information about the NIC being controlled by
the UNDI.
E.4.6.1
Issuing the Command
To issue a Get Config Info command, create a CDB and fill it in as shown in the table below:
CDB Field
How to initialize the CDB structure for a Get Config Info command
OpCode
PXE_OPCODE_GET_CONFIG_INFO
OpFlags
PXE_OPFLAGS_NOT_USED
CPBsize
PXE_CPBSIZE_NOT_USED
DBsize
sizeof(PXE_DB_CONFIG_INFO)
CPBaddr
PXE_CPBADDR_NOT_USED
DBaddr
Address of a
PXE_DB_CONFIG_INFO
structure
StatCode
PXE_STATCODE_INITIALIZE
StatFlags
PXE_STATFLAGS_INITIALIZE
IFnum
A valid interface number from zero to
!PXE.IFcnt
Control
Set as needed
E.4.6.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 has been written.
COMMAND_FAILED
Command failed. StatCode field contains error code.
COMMAND_QUEUED
Command has been queued.
INITIALIZE
Command has been not executed or queued.