Inside Macintosh: Open Transport /

Chapter 3 - Endpoints / Endpoints Reference

Functions / Doing No-Copy Receives

OTReadBuffer

Reads the next portion of a no-copy receive buffer.

C INTERFACE

Boolean OTReadBuffer (OTBufferInfo* info, void* buf, size_t* len);

C++ INTERFACE

None. C++ applications use the C interface to this function.

PARAMETERS

info

A pointer to the buffer information structure to be read.

buf

A pointer to a buffer into which to place the data.

len

The number of bytes actually read.

DESCRIPTION

This function returns true when it has read all of the bytes from the buffer information structure pointed to by the info parameter. It returns false when there are more bytes still to be read.

VALID STATES

All

SEE ALSO

The OTReleaseBuffer function (page 3-98) obtains the size of the no-copy receive buffer and the OTBuffer (page 3-98) function reads from this buffer.

The no-copy receive buffer structure is described by the OTBuffer data type (page 3-53).