Contents

getFormatCapacities

Declaration

virtual UInt32 getFormatCapacities(
 UInt64 *capacities, 
 UInt32capacitiesMaxCount) const;

Parameters

  • capacities:

    Buffer that will receive the UInt64 capacity values.

  • capacitiesMaxCount:

    Maximum number of capacity values that can be held in the buffer.

Return Value

Actual number of capacity values copied to the buffer, or if no buffer is given, the total number of capacity values available.

Overview

Ask the driver to report the feasible formatting capacities for the inserted media (in bytes). This routine fills the caller's buffer, up to the maximum count specified if the real number of capacities would overflow the buffer. The return value indicates the actual number of capacities copied to the buffer.

If the capacities buffer is not supplied or if the maximum count is zero, the routine returns the proposed count of capacities instead.

See Also

Miscellaneous