Returns the maximum capacity of this buffer.
Remarks: Each buffer has a capacity, a limit, and a position. The capacity is the maximum content a buffer can contain, limit represents the extent of valid content, and position marks the current read location.
Access buffer capacity.