Efi_simple_network.getstatus(), Getstatus() – Intel Extensible Firmware Interface User Manual
Page 626
Extensible Firmware Interface Specification
15-20
12/01/02
Version 1.10
EFI_SIMPLE_NETWORK.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
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