Intel Extensible Firmware Interface Network Router User Manual


  Open as PDF
of 1084
 
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 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