---
title: getPhysicalSegment
framework: kernel
role: pseudoSymbol
path: kernel/iointerleavedmemorydescriptor/1812587-getphysicalsegment
---

# getPhysicalSegment

Break a memory descriptor into its physically contiguous segments.

## Declaration

```occ
virtual addr64_t getPhysicalSegment(
 IOByteCountoffset, 
 IOByteCount *length, 
 IOOptionBits options = 0 ); 
```

## Parameters

- `offset`: A byte offset into the memory whose physical address to return.
- `length`: If non-zero, getPhysicalSegment will store here the length of the physically contiguous segement at the given offset.

## Return Value

Return Value A physical address, or zero if the offset is beyond the length of the memory.

## Overview

Overview This method returns the physical address of the byte at the given offset into the memory, and optionally the length of the physically contiguous segment from that offset.

## See Also

### Miscellaneous

- [clearMemoryDescriptors](kernel/iointerleavedmemorydescriptor/1812566-clearmemorydescriptors.md)
- [complete](kernel/iointerleavedmemorydescriptor/1812579-complete.md)
- [initWithCapacity](kernel/iointerleavedmemorydescriptor/1812598-initwithcapacity.md)
- [prepare](kernel/iointerleavedmemorydescriptor/1812608-prepare.md)
- [setMemoryDescriptor](kernel/iointerleavedmemorydescriptor/1812618-setmemorydescriptor.md)
- [withCapacity](kernel/iointerleavedmemorydescriptor/1812626-withcapacity.md)