Efi_simple_network.getstatus(), Getstatus() – Intel Extensible Firmware Interface User Manual

Page 626

Advertising
background image

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

Advertising