E.4.5 get init info, Get init info, E.4.5.1 issuing the command – Intel Extensible Firmware Interface User Manual

Page 915: E.4.5.2 waiting for the command to execute, E.4.5.3 checking command execution results

Advertising
background image

32/64-Bit UNDI Specification

Version 1.10

12/01/02

E-49

E.4.5

Get Init Info

This command is used to retrieve initialization information that is needed by drivers and
applications to initialized UNDI.

E.4.5.1

Issuing the Command

To issue a Get Init Info command, create a CDB and fill it in as shows in the table below:

CDB Field

How to initialize the CDB structure for a Get Init Info command

OpCode

PXE_OPCODE_GET_INIT_INFO

OpFlags

PXE_OPFLAGS_NOT_USED

CPBsize

PXE_CPBSIZE_NOT_USED

DBsize

sizeof(PXE_DB_INIT_INFO)

CPBaddr

PXE_CPBADDR_NOT_USED

DBaddr

Address of a

PXE_DB_INIT_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.5.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 can be used.

COMMAND_FAILED

Command failed. StatCode field contains error code.

COMMAND_QUEUED

Command has been queued.

INITIALIZE

Command has been not executed or queued.

E.4.5.3

Checking Command Execution Results

After command execution completes, either successfully or not, the

CDB.StatCode

field

contains the result of the command execution.

StatCode Reason

SUCCESS

Command completed successfully. DB can be used.

INVALID_CDB

One of the CDB fields was not set correctly.

BUSY

UNDI is already processing commands. Try again later.

QUEUE_FULL

Command queue is full. Try again later.

NOT_STARTED

The UNDI is not started.

Advertising