---
title: withSpecification
framework: kernel
role: pseudoSymbol
path: kernel/iomemorycursor/1812453-withspecification
---

# withSpecification

Creates and initializes an IOMemoryCursor in one operation.

## Declaration

```occ
static IOMemoryCursor * withSpecification(
 SegmentFunction outSegFunc, 
 IOPhysicalLength maxSegmentSize = 0, 
 IOPhysicalLength maxTransferSize = 0, 
 IOPhysicalLength alignment = 1); 
```

## Parameters

- `outSegFunc`: SegmentFunction to call to output one physical segment.
- `maxSegmentSize`: Maximum allowable size for one segment. Defaults to 0.
- `maxTransferSize`: Maximum size of an entire transfer. Defaults to 0 indicating no maximum.
- `alignment`: Alignment restrictions on output physical addresses. Not currently implemented. Defaults to single byte alignment.

## Return Value

Return Value Returns a new memory cursor if successfully created and initialized, 0 otherwise.

## Overview

Overview Factory function to create and initialize an IOMemoryCursor in one operation. For more information, see IOMemoryCursor::initWithSpecification.

## See Also

### Miscellaneous

- [genPhysicalSegments](kernel/iomemorycursor/1812441-genphysicalsegments.md)
- [initWithSpecification](kernel/iomemorycursor/1812445-initwithspecification.md)