Intel Extensible Firmware Interface, Specification

Page: 314 / 494

Extensible Firmware Interface Specification
296 12/12/00 Version 1.02
15.1.11 EFI_SIMPLE_NETWO RK.GetStatus()
Summary
Reads the current interrupt status and recycled transmit buffer status from a network interface.
Prototype
EFI_STATUS
(EFIAPI *EFI_SIMPLE_NETWORK_GET_STATUS) (
IN EFI_SIMPLE_NETWORK *This,
OUT UINT32 *InterruptStatus OPTIONAL ,
OUT VOID **TxBuf OPTIONAL
);
Parameters
This
A pointer to the
EFI_SIMPLE_NETWORK
instance.
InterruptStatus
A pointer to the bit mask of the currently active interrupts (see
“Related Definitions”). If this is
NULL
, the interrupt status will
not be read from the device. If this is not
NULL
, the interrupt
status will be read from the device. When the interrupt status is
read, it will also be cleared. Clearing the transmit interrupt does
not empty the recycled transmit buffer array.
TxBuf
Recycled transmit buffer address. The network interface will not
transmit if its internal recycled transmit buffer array is full.
Reading the transmit buffer does not clear the transmit interrupt.
If this is
NULL
, then the transmit buffer status will not be read.
If there are no transmit buffers to recycle and
TxBuf
is not
NULL
, *
TxBuf
will be set to
NULL
.
Related Definitions
//*******************************************************
// Interrupt Bit Mask Settings for InterruptStatus .
// Note that all other bit values are reserved.
//*******************************************************
#define EFI_SIMPLE_NETWORK_RECEIVE_INTERRUPT 0x01
#define EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT 0x02
#define EFI_SIMPLE_NETWORK_COMMAND_INTERRUPT 0x04
#define EFI_SIMPLE_NETWORK_SOFTWARE_INTERRUPT 0x08