The caller sleeps until the next transmit interrupt occurs for the designated queue. The sleep occurs on a counting semaphore so that the count accumulates for every transmit interrupt. When configured, transmit interrupts occur for every packet transmitted. A microsecond-resolution timeout value may be specified which is rounded to the nearest system clock tick, or INFINITE to indicate that the caller should block until the operation is complete.

Note: This call must be made if hpeOpen was called with the OUTPUT_INTERRUPT flag set.

HPESTATUS mhpeWaitForTransmitComplete(
    MPEHANDLE   ephandle,
    uint32_t    timeout_us
);

Parameters

ephandle

The ephandle.

timeout_us

The timeout us.

Return Values

A HPESTATUS value indicating the success or failure of the operation.

Status

E_OK

The operation completed successfully.

E_EXIST

The handle given is not a valid transmit endpoint handle.

E_TIME

The call timed out before the operation was complete.

E_STATE

The driver is not operating in transmit-interrupt mode.

E_LIMIT

The queue_index parameter is out of bounds for the current hardware.

E_TRANSMISSION

The physical link is down; no buffers can be added to the queue.
If this condition is received, terminate any outstanding receive operation, then close the interface (hpeClose) and reinitialize the software before reopening the interface.

Requirements