G.4.16 Get Status - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
G.4.16 Get Status
This command returns the current interrupt status and/or the transmitted buffer addresses. If the
current interrupt status is returned, pending interrupts will be acknowledged by this command.
Transmitted buffer addresses that are written to the DB are removed from the transmitted buffer
queue.
This command may be used in a polled fashion with external interrupts disabled.
G.4.16.1 Issuing the Command
To issue a Get Status command, create a CDB and fill it in as shows in the table below:
CDB Field
OpCode
OpFlags
CPBsize
DBsize
CPBaddr
DBaddr
StatCode
StatFlags
IFnum
Control
Setting OpFlags
Set one or both of the OpFlags below to return the interrupt status and/or the transmitted buffer
addresses.
•
PXE_OPFLAGS_GET_INTERRUPT_STATUS
•
PXE_OPFLAGS_GET_TRANSMITTED_BUFFERS
G.4.16.2 Waiting for the Command to Execute
Monitor the upper two bits (14 & 15) in the
report
PXE_STATFLAGS_COMMAND_COMPLETE
the command has not been executed by the UNDI.
StatFlags
COMMAND_COMPLETE
COMMAND_FAILED
COMMAND_QUEUED
INITIALIZE
454
How to initialize the CDB structure for a Get Status command
PXE_OPCODE_GET_STATUS
Set as needed.
PXE_CPBSIZE_NOT_USED
Sizeof(PXE_DB_GET_STATUS)
PXE_CPBADDR_NOT_USED
Address of
PXE_DB_GET_STATUS
PXE_STATCODE_INITIALIZE
PXE_STATFLAGS_INITIALIZE
A valid interface number from zero to !PXE.IFcnt.
Set as needed.
CDB.StatFlags
Reason
Command completed successfully. StatFlags and/or DB are updated.
Command failed. StatCode field contains error code.
Command has been queued.
Command has been not executed or queued.
12/12/00
structure.
field. Until these bits change to
or PXE_STATFLAGS_COMMAND_FAILED,
Version 1.02