hpeGetTransmitQueueState

Returns a value indicating the current state of the transmitter for the designated queue. This is used to determine whether the transmit buffers may be reset. If the transmitter is currently active then it is not advised to reset the buffers to avoid a race condition between the transmitter and the CPU.

HPESTATUS hpeGetTransmitQueueState(
    HPEHANDLE devhandle,
    DWORD queue_index, 
    DWORD *txstate_p
);

Parameters

devhandle

A handle value for the device.

queue_index

Index of the designated queue.

txstate_p

A pointer to a DWORD value to receive the transmitter state. This value may be:

`HPE_TXIDLE`	The transmitter is currently idle.
`HPE_TXBUSY`	The transmitter is performing an operation.
`E_LIMIT`	The `queue_index` parameter is out of bounds for the current hardware.

Return Values

A status value indicating the success or failure of the operation:

`E_OK`	The operation completed successfully.
`E_EXIST`	The handle given is not a handle for an open HPE interface.

Notes

If used in conjunction with hpeWaitForTransmitComplete or hpeWaitForTransmitQueueComplete, care must be taken to not leave completion state outstanding on the queue. This may be accomplished by draining the queue with a timeout of 0.

Requirements

Versions	Defined in	Include	Link to
INtime 6.0 (HPE3)	intime/rt/include/hpeif2.h	hpeif2.h	hpeif2.lib