SetLength
Changes the length of the memory buffer.
Declaration
virtual kern_return_t SetLength(uint64_t length);Parameters
- length:
The new length of the memory buffer. This value must be less than or equal to the buffer’s capacity.
Return Value
kIOReturnSuccess on success, or another value if an error occurs. See Error Codes.
Discussion
Use this method to truncate an existing memory buffer. For example, you might call this method when repurposing an existing buffer for a new data type. The maximum capacity of the buffer remains unchanged, but the effective length of the buffer changes to the value you specify.