get_region_data


unsigned get_region_data(handle region,
                         unsigned count,
                         region_data* data)

This function obtains the data of a region.

Parameters

handle region

The handle of the region whose data is being queried.

unsigned count

The size (in bytes) of the buffer pointed to by the next parameter.

region_data* data

A pointer to a buffer to receive the region data. If null is specified, the required buffer size is returned and no data is transferred.

Return

unsigned

false The call failed.
true The function succeeded and the data was transferred.
Other The required buffer size. In this case, either the count was too small or the buffer pointer was null.

Notes

Data obtained through this function is in a format suitable for the function extended_create_region.