beautypg.com

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

background image

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.