Returns a pointer to the next receive buffer which has a fully-received frame in it for the designated queue. The pointer refers to the buffer which is used by the DMA engine, so if the data is required after the next cycle takes place it will need to be copied out of the buffer, or there should be sufficient receive buffers for multiple cycles.

If no buffer is available, the call returns a failing status.

HPESTATUS hpeGetReceiveQueueBuffer(
    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 variable to which will be returned a point to a HPEBUFFER structure describing the next receive buffer which contains a received frame. The used field of the structure will indicate how many bytes of frame data are contained in the buffer.

Return Values

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

Requirements