---
name: "afInitAESChannelDataTo"
section: "3"
platform: "linux"
package: "audiofile"
version: "0.3.6-12"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/afInitAESChannelDataTo"
---

# afInitAESChannelDataTo(3)

initialize AES non-audio data in an audio file setup

## NAME

afInitAESChannelDataTo, afInitAESChannelData - initialize AES non-audio data in an audio file setup

## SYNOPSIS

```
#include <audiofile.h>
```

```
void afInitAESChannelDataTo(AFfilesetup setup, int track, int willHaveData);
void afInitAESChannelData(AFfilesetup setup, int track);
```

## PARAMETERS

setup is a valid file setup returned by [**afNewFileSetup**(3)](/afNewFileSetup/3.md).

track specifies a track within the audio file setup. track is always AF\_DEFAULT\_TRACK for all currently supported file formats.

willHaveData is a boolean-valued integer indicating whether AES non-audio data will be present.

## DESCRIPTION

Given an AFfilesetup structure created with [**afNewFileSetup**(3)](/afNewFileSetup/3.md) and a track identified by track (AF\_DEFAULT\_TRACK for all currently supported file formats), afInitAESChannelDataTo initializes the track to contain or not contain AES non-audio data. afInitAESChannelData behaves similarly but always initializes the track to contain AES non-audio data.

Currently only AIFF and AIFF-C file formats can store AES non-audio data; this data is ignored in all other file formats.

## ERRORS

afInitAESChannelDataTo and afInitAESChannelData can produce the following errors:

AF\_BAD\_FILESETUP

setup represents an invalid file setup.

AF\_BAD\_TRACKID

track represents an invalid track identifier.

## SEE ALSO

[**afNewFileSetup**(3)](/afNewFileSetup/3.md)

## AUTHOR

Michael Pruett \<michael@68k.org\>