INtime SDK Help
hpeReturnReceiveQueueBuffer
INtime SDK v6 > About INtime > Networking and I/O > High-Performance Ethernet > hpeReturnReceiveQueueBuffer

Returns the receive buffer obtained by hpeGetReceiveQueueBuffer to the designated queue of the network device. This call may be used only if the device have been opened with the RETURN_RECEIVE_BUFFER option set in hpeOpen. When opened in this mode, the buffer returned by hpeGetReceiveQueueBuffer is owned by the user application and will not be overwritten by the network device until this call is made to return the buffer to the device.

HPESTATUS hpeReturnReceiveQueueBuffer(
    HPEHANDLE devhandle, 
DWORD queue_index, HPEBUFFER *buffer_ptr );

Parameters

devhandle
A handle value for the device.
queue_index
The index for the designated queue
buffer_ptr
A pointer to a HPEBUFFER returned by hpeGetReceiveBuffer.

Return Values

A status value indicating the success or failure of the operation. This may be one of the following:

E_OK The operation completed successfully.
E_EXIST The handle given is not a handle for a HPE interface.
E_PARAM The buffer_ptr is not valid.

Remarks

For architectural reasons, this call is not supported in the rtl100m driver.

Requirements

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