472 /** |
472 /** |
473 * Ensures that the buffer has a minimum capacity. |
473 * Ensures that the buffer has a minimum capacity. |
474 * |
474 * |
475 * If the current capacity is not sufficient, the buffer will be extended. |
475 * If the current capacity is not sufficient, the buffer will be extended. |
476 * |
476 * |
|
477 * The new capacity will be a power of two until the system's page size is reached. |
|
478 * Then, the new capacity will be a multiple of the page size. |
|
479 * |
477 * @param buffer the buffer |
480 * @param buffer the buffer |
478 * @param capacity the minimum required capacity for this buffer |
481 * @param capacity the minimum required capacity for this buffer |
479 * @retval zero the capacity was already sufficient or successfully increased |
482 * @retval zero the capacity was already sufficient or successfully increased |
480 * @retval non-zero on allocation failure |
483 * @retval non-zero on allocation failure |
481 * @see cxBufferShrink() |
484 * @see cxBufferShrink() |