---
title: CMGetProfileByAVID
framework: Application Services
role: pseudoSymbol
platforms: []
path: applicationservices/colorsync_manager/1804955-cmgetprofilebyavid
---

# CMGetProfileByAVID

Gets the current profile for a monitor.

## Declaration

```occ
CMError CMGetProfileByAVID (
   CMDisplayIDType theID,
   CMProfileRef *prof
);
```

## Parameters

- `theAVID`: A Display Manager ID value. You pass the ID value for the monitor for which to get the profile.
- `prof`: A pointer to a profile reference. On return, a reference to the current profile for the monitor specified by `theAVID`.

## Return Value

A `CMError` value. See [Result Codes](../colorsync_manager.md).

## Overview

If the Display Manager supports ColorSync, the `CMGetProfileByAVID` function calls on the Display Manager to get the profile for the specified display. This is the case if the version of the Display Manager is 2.2.5 or higher (if `gestaltDisplayMgrAttr` has the `gestaltDisplayMgrColorSyncAware` bit set). 

## See Also

### Accessing Special Profiles

- [CMGetSystemProfile](1804926-cmgetsystemprofile.md)
- [CMSetSystemProfile](1804932-cmsetsystemprofile.md)
- [NCMSetSystemProfile](1804936-ncmsetsystemprofile.md)
- [CMGetDefaultProfileBySpace](1804940-cmgetdefaultprofilebyspace.md)
- [CMSetDefaultProfileBySpace](1804944-cmsetdefaultprofilebyspace.md)
- [CMGetDefaultProfileByUse](1804948-cmgetdefaultprofilebyuse.md)
- [CMSetDefaultProfileByUse](1804951-cmsetdefaultprofilebyuse.md)
- [CMSetProfileByAVID](1804959-cmsetprofilebyavid.md)