---
title: doFormatMedia
framework: kernel
role: pseudoSymbol
path: kernel/ioblockstoragedevice/1811680-doformatmedia
---

# doFormatMedia

Format the media to the specified byte capacity.

## Declaration

```occ
virtual IOReturn doFormatMedia(
 UInt64byteCapacity) = 0; 
```

## Parameters

- `byteCapacity`: The byte capacity to which the device is to be formatted, if possible.

## Overview

Overview The specified byte capacity must be one supported by the device. Supported capacities can be obtained by calling doGetFormatCapacities.

## See Also

### Miscellaneous

- [doAsyncReadWrite](kernel/ioblockstoragedevice/1811665-doasyncreadwrite.md)
- [doEjectMedia](kernel/ioblockstoragedevice/1811672-doejectmedia.md)
- [doGetFormatCapacities](kernel/ioblockstoragedevice/1811684-dogetformatcapacities.md)
- [doSynchronizeCache](kernel/ioblockstoragedevice/1811691-dosynchronizecache.md)
- [doUnmap](kernel/ioblockstoragedevice/1811698-dounmap.md)
- [getAdditionalDeviceInfoString](kernel/ioblockstoragedevice/1811705-getadditionaldeviceinfostring.md)
- [getProductString](kernel/ioblockstoragedevice/1811712-getproductstring.md)
- [getRevisionString](kernel/ioblockstoragedevice/1811717-getrevisionstring.md)
- [getVendorString](kernel/ioblockstoragedevice/1811724-getvendorstring.md)
- [getWriteCacheState](kernel/ioblockstoragedevice/1811731-getwritecachestate.md)
- [init](kernel/ioblockstoragedevice/1811746-init.md)
- [reportBlockSize](kernel/ioblockstoragedevice/1811753-reportblocksize.md)
- [reportEjectability](kernel/ioblockstoragedevice/1811761-reportejectability.md)
- [reportMaxValidBlock](kernel/ioblockstoragedevice/1811771-reportmaxvalidblock.md)
- [reportMediaState](kernel/ioblockstoragedevice/1811780-reportmediastate.md)
- [reportRemovability](kernel/ioblockstoragedevice/1811787-reportremovability.md)
- [reportWriteProtection](kernel/ioblockstoragedevice/1811796-reportwriteprotection.md)
- [requestIdle](kernel/ioblockstoragedevice/1811804-requestidle.md)
- [setWriteCacheState](kernel/ioblockstoragedevice/1811812-setwritecachestate.md)