AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
=>     R0 =     buffer's flag word
     R1 =     size of buffer to be created
     R2 =     preferred handle for the buffer, -1 to get the buffer manager to generate one
<=     R0 =     buffer handle

This claims an area of the RMA and registers it as a buffer. It can at most hold R1-1 bytes.
If R2 <>-1, the given number is checked for uniqueness, if it already exists, a new one is generated.

Note that you do not need any complicated calculations to write data into the buffer - it's a simply a block of memory. Get the address with Buffer_GetInfo and write to the buffer.

See PRM 4, page 86.

[sh-index] Back to list of manuals