Buffer Parameters

Some methods include one or more parameters intended for use as a binary data buffer. Depending on the method, these parameters may contain data when the method is called, or the method is expected to fill the buffer with data.

The documentation for such methods will describe which of the above cases applies to each buffer parameters. Note that, in all cases, buffer parameters point to a pre-allocated block of memory, the size of which is specified by the parameter immediately following the buffer parameter. In cases where data is to be written, be sure to write it directly to the pointed-to memory, don't change the value of the buffer parameter itself.