E.4.3 start, Start, E.4.3.1 issuing the command – Intel Extensible Firmware Interface User Manual

Page 909

Advertising
background image

32/64-Bit UNDI Specification

Version 1.10

12/01/02

E-43

E.4.3 Start

This command is used to change the UNDI operational state from stopped to started. No other
operational checks are made by this command. Protocol driver makes this call for each network
interface supported by the UNDI with a set of call back routines and a unique identifier to identify
the particular interface. UNDI does not interpret the unique identifier in any way except that it is a
64-bit value and it will pass it back to the protocol driver as a parameter to all the call back routines
for any particular interface. If this is a S/W UNDI, the callback functions Delay(), Virt2Phys(),
Map_Mem(), UnMap_Mem(), and Sync_Mem() functions will not be called by this command.

E.4.3.1

Issuing the Command

To issue a Start command for H/W UNDI, create a CDB and fill it in as shows in the table below:

CDB Field

How to initialize the CDB structure for a H/W UNDI Start command

OpCode

PXE_OPCODE_START

OpFlags

PXE_OPFLAGS_NOT_USED

CPBsize

PXE_CPBSIZE_NOT_USED

DBsize

PXE_DBSIZE_NOT_USED

CPBaddr

PXE_CPBADDR_NOT_USED

DBaddr

PXE_DBADDR_NOT_USED

StatCode

PXE_STATCODE_INITIALIZE

StatFlags

PXE_STATFLAGS_INITIALIZE

IFnum

A valid interface number from zero to

!PXE.IFcnt

Control

Set as needed

To issue a Start command for S/W UNDI, create a CDB and fill it in as shows in the table below:

CDB Field

How to initialize the CDB structure for a S/W UNDI Start command

OpCode

PXE_OPCODE_START

OpFlags

PXE_OPFLAGS_NOT_USED

CPBsize

sizeof(PXE_CPB_START)

DBsize

PXE_DBSIZE_NOT_USED

CPBaddr

Address of a

PXE_CPB_START

structure.

DBaddr

PXE_DBADDR_NOT_USED

StatCode

PXE_STATCODE_INITIALIZE

StatFlags

PXE_STATFLAGS_INITIALIZE

IFnum

A valid interface number from zero to

!PXE.IFcnt

Control

Set as needed

Advertising