Documentation Archive Developer
Search

AudioUnit Changes for Objective-C

AudioUnit

AUAudioUnit.h (Added)

Added AUAudioUnit(AUAudioInputOutputUnit)

AUAudioUnitImplementation.h (Added)

Added AUAudioUnit(AUAudioUnitImplementation)
Added AUAudioUnitBus(AUAudioUnitImplementation)
Added AUAudioUnitBusArray(AUAudioUnitBusImplementation)
Added AUParameterNode(AUParameterNodeImplementation)
Added AUParameterTree(Factory)

AUCocoaUIView.h

Declaration
From
- (NSView *)uiViewForAudioUnit:(AudioUnit)inAudioUnit withSize:(NSSize)inPreferredSize
To
- (NSView * _Nullable)uiViewForAudioUnit:(AudioUnit _Nonnull)inAudioUnit withSize:(NSSize)inPreferredSize

AUComponent.h

Declaration
From
OSStatus AudioUnitAddPropertyListener (
    AudioUnit inUnit,
    AudioUnitPropertyID inID,
    AudioUnitPropertyListenerProc inProc,
    void *inProcUserData
);
To
OSStatus AudioUnitAddPropertyListener (
    AudioUnit _Nonnull inUnit,
    AudioUnitPropertyID inID,
    AudioUnitPropertyListenerProc _Nonnull inProc,
    void * _Nullable inProcUserData
);

Declaration
From
OSStatus AudioUnitAddRenderNotify (
    AudioUnit inUnit,
    AURenderCallback inProc,
    void *inProcUserData
);
To
OSStatus AudioUnitAddRenderNotify (
    AudioUnit _Nonnull inUnit,
    AURenderCallback _Nonnull inProc,
    void * _Nullable inProcUserData
);

Declaration
From
OSStatus AudioUnitGetParameter (
    AudioUnit inUnit,
    AudioUnitParameterID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    AudioUnitParameterValue *outValue
);
To
OSStatus AudioUnitGetParameter (
    AudioUnit _Nonnull inUnit,
    AudioUnitParameterID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    AudioUnitParameterValue * _Nonnull outValue
);

Declaration
From
OSStatus AudioUnitGetProperty (
    AudioUnit inUnit,
    AudioUnitPropertyID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    void *outData,
    UInt32 *ioDataSize
);
To
OSStatus AudioUnitGetProperty (
    AudioUnit _Nonnull inUnit,
    AudioUnitPropertyID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    void * _Nonnull outData,
    UInt32 * _Nonnull ioDataSize
);

Declaration
From
OSStatus AudioUnitGetPropertyInfo (
    AudioUnit inUnit,
    AudioUnitPropertyID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    UInt32 *outDataSize,
    Boolean *outWritable
);
To
OSStatus AudioUnitGetPropertyInfo (
    AudioUnit _Nonnull inUnit,
    AudioUnitPropertyID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    UInt32 * _Nullable outDataSize,
    Boolean * _Nullable outWritable
);

Declaration
From
OSStatus AudioUnitInitialize (
    AudioUnit inUnit
);
To
OSStatus AudioUnitInitialize (
    AudioUnit _Nonnull inUnit
);

Declaration
From
OSStatus AudioUnitProcess (
    AudioUnit inUnit,
    AudioUnitRenderActionFlags *ioActionFlags,
    const AudioTimeStamp *inTimeStamp,
    UInt32 inNumberFrames,
    AudioBufferList *ioData
);
To
OSStatus AudioUnitProcess (
    AudioUnit _Nonnull inUnit,
    AudioUnitRenderActionFlags * _Nullable ioActionFlags,
    const AudioTimeStamp * _Nonnull inTimeStamp,
    UInt32 inNumberFrames,
    AudioBufferList * _Nonnull ioData
);

Declaration
From
OSStatus AudioUnitProcessMultiple (
    AudioUnit inUnit,
    AudioUnitRenderActionFlags *ioActionFlags,
    const AudioTimeStamp *inTimeStamp,
    UInt32 inNumberFrames,
    UInt32 inNumberInputBufferLists,
    const AudioBufferList **inInputBufferLists,
    UInt32 inNumberOutputBufferLists,
    AudioBufferList **ioOutputBufferLists
);
To
OSStatus AudioUnitProcessMultiple (
    AudioUnit _Nonnull inUnit,
    AudioUnitRenderActionFlags * _Nullable ioActionFlags,
    const AudioTimeStamp * _Nonnull inTimeStamp,
    UInt32 inNumberFrames,
    UInt32 inNumberInputBufferLists,
    const AudioBufferList * _Nonnull * _Nonnull inInputBufferLists,
    UInt32 inNumberOutputBufferLists,
    AudioBufferList * _Nonnull * _Nonnull ioOutputBufferLists
);

Modified AudioUnitRemovePropertyListener()
Declaration
From
OSStatus AudioUnitRemovePropertyListener (
    AudioUnit inUnit,
    AudioUnitPropertyID inID,
    AudioUnitPropertyListenerProc inProc
);
To
OSStatus AudioUnitRemovePropertyListener (
    AudioUnit _Nonnull inUnit,
    AudioUnitPropertyID inID,
    AudioUnitPropertyListenerProc _Nonnull inProc
);

Declaration
From
OSStatus AudioUnitRemovePropertyListenerWithUserData (
    AudioUnit inUnit,
    AudioUnitPropertyID inID,
    AudioUnitPropertyListenerProc inProc,
    void *inProcUserData
);
To
OSStatus AudioUnitRemovePropertyListenerWithUserData (
    AudioUnit _Nonnull inUnit,
    AudioUnitPropertyID inID,
    AudioUnitPropertyListenerProc _Nonnull inProc,
    void * _Nullable inProcUserData
);

Declaration
From
OSStatus AudioUnitRemoveRenderNotify (
    AudioUnit inUnit,
    AURenderCallback inProc,
    void *inProcUserData
);
To
OSStatus AudioUnitRemoveRenderNotify (
    AudioUnit _Nonnull inUnit,
    AURenderCallback _Nonnull inProc,
    void * _Nullable inProcUserData
);

Declaration
From
OSStatus AudioUnitRender (
    AudioUnit inUnit,
    AudioUnitRenderActionFlags *ioActionFlags,
    const AudioTimeStamp *inTimeStamp,
    UInt32 inOutputBusNumber,
    UInt32 inNumberFrames,
    AudioBufferList *ioData
);
To
OSStatus AudioUnitRender (
    AudioUnit _Nonnull inUnit,
    AudioUnitRenderActionFlags * _Nullable ioActionFlags,
    const AudioTimeStamp * _Nonnull inTimeStamp,
    UInt32 inOutputBusNumber,
    UInt32 inNumberFrames,
    AudioBufferList * _Nonnull ioData
);

Declaration
From
OSStatus AudioUnitReset (
    AudioUnit inUnit,
    AudioUnitScope inScope,
    AudioUnitElement inElement
);
To
OSStatus AudioUnitReset (
    AudioUnit _Nonnull inUnit,
    AudioUnitScope inScope,
    AudioUnitElement inElement
);

Declaration
From
OSStatus AudioUnitScheduleParameters (
    AudioUnit inUnit,
    const AudioUnitParameterEvent *inParameterEvent,
    UInt32 inNumParamEvents
);
To
OSStatus AudioUnitScheduleParameters (
    AudioUnit _Nonnull inUnit,
    const AudioUnitParameterEvent * _Nonnull inParameterEvent,
    UInt32 inNumParamEvents
);

Declaration
From
OSStatus AudioUnitSetParameter (
    AudioUnit inUnit,
    AudioUnitParameterID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    AudioUnitParameterValue inValue,
    UInt32 inBufferOffsetInFrames
);
To
OSStatus AudioUnitSetParameter (
    AudioUnit _Nonnull inUnit,
    AudioUnitParameterID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    AudioUnitParameterValue inValue,
    UInt32 inBufferOffsetInFrames
);

Declaration
From
OSStatus AudioUnitSetProperty (
    AudioUnit inUnit,
    AudioUnitPropertyID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    const void *inData,
    UInt32 inDataSize
);
To
OSStatus AudioUnitSetProperty (
    AudioUnit _Nonnull inUnit,
    AudioUnitPropertyID inID,
    AudioUnitScope inScope,
    AudioUnitElement inElement,
    const void * _Nullable inData,
    UInt32 inDataSize
);

Declaration
From
OSStatus AudioUnitUninitialize (
    AudioUnit inUnit
);
To
OSStatus AudioUnitUninitialize (
    AudioUnit _Nonnull inUnit
);

Deprecation
From--
ToOS X 10.11

Deprecation
From--
ToOS X 10.11

IntroductionDeprecation
FromOS X 10.2--
ToOS X 10.3OS X 10.10

AudioCodec.h

Added #def AudioUnit_AudioCodec_h
Declaration
From
OSStatus AudioCodecAppendInputBufferList (
    AudioCodec inCodec,
    const AudioBufferList *inBufferList,
    UInt32 *ioNumberPackets,
    const AudioStreamPacketDescription *inPacketDescription,
    UInt32 *outBytesConsumed
);
To
OSStatus AudioCodecAppendInputBufferList (
    AudioCodec _Nonnull inCodec,
    const AudioBufferList * _Nonnull inBufferList,
    UInt32 * _Nonnull ioNumberPackets,
    const AudioStreamPacketDescription * _Nullable inPacketDescription,
    UInt32 * _Nonnull outBytesConsumed
);

Declaration
From
OSStatus AudioCodecAppendInputData (
    AudioCodec inCodec,
    const void *inInputData,
    UInt32 *ioInputDataByteSize,
    UInt32 *ioNumberPackets,
    const AudioStreamPacketDescription *inPacketDescription
);
To
OSStatus AudioCodecAppendInputData (
    AudioCodec _Nonnull inCodec,
    const void * _Nonnull inInputData,
    UInt32 * _Nonnull ioInputDataByteSize,
    UInt32 * _Nonnull ioNumberPackets,
    const AudioStreamPacketDescription * _Nullable inPacketDescription
);

Declaration
From
OSStatus AudioCodecGetProperty (
    AudioCodec inCodec,
    AudioCodecPropertyID inPropertyID,
    UInt32 *ioPropertyDataSize,
    void *outPropertyData
);
To
OSStatus AudioCodecGetProperty (
    AudioCodec _Nonnull inCodec,
    AudioCodecPropertyID inPropertyID,
    UInt32 * _Nonnull ioPropertyDataSize,
    void * _Nonnull outPropertyData
);

Declaration
From
OSStatus AudioCodecGetPropertyInfo (
    AudioCodec inCodec,
    AudioCodecPropertyID inPropertyID,
    UInt32 *outSize,
    Boolean *outWritable
);
To
OSStatus AudioCodecGetPropertyInfo (
    AudioCodec _Nonnull inCodec,
    AudioCodecPropertyID inPropertyID,
    UInt32 * _Nullable outSize,
    Boolean * _Nullable outWritable
);

Declaration
From
OSStatus AudioCodecInitialize (
    AudioCodec inCodec,
    const AudioStreamBasicDescription *inInputFormat,
    const AudioStreamBasicDescription *inOutputFormat,
    const void *inMagicCookie,
    UInt32 inMagicCookieByteSize
);
To
OSStatus AudioCodecInitialize (
    AudioCodec _Nonnull inCodec,
    const AudioStreamBasicDescription * _Nullable inInputFormat,
    const AudioStreamBasicDescription * _Nullable inOutputFormat,
    const void * _Nullable inMagicCookie,
    UInt32 inMagicCookieByteSize
);

Declaration
From
OSStatus AudioCodecProduceOutputBufferList (
    AudioCodec inCodec,
    AudioBufferList *ioBufferList,
    UInt32 *ioNumberPackets,
    AudioStreamPacketDescription *outPacketDescription,
    UInt32 *outStatus
);
To
OSStatus AudioCodecProduceOutputBufferList (
    AudioCodec _Nonnull inCodec,
    AudioBufferList * _Nonnull ioBufferList,
    UInt32 * _Nonnull ioNumberPackets,
    AudioStreamPacketDescription * _Nullable outPacketDescription,
    UInt32 * _Nonnull outStatus
);

Declaration
From
OSStatus AudioCodecProduceOutputPackets (
    AudioCodec inCodec,
    void *outOutputData,
    UInt32 *ioOutputDataByteSize,
    UInt32 *ioNumberPackets,
    AudioStreamPacketDescription *outPacketDescription,
    UInt32 *outStatus
);
To
OSStatus AudioCodecProduceOutputPackets (
    AudioCodec _Nonnull inCodec,
    void * _Nonnull outOutputData,
    UInt32 * _Nonnull ioOutputDataByteSize,
    UInt32 * _Nonnull ioNumberPackets,
    AudioStreamPacketDescription * _Nullable outPacketDescription,
    UInt32 * _Nonnull outStatus
);

Declaration
From
OSStatus AudioCodecReset (
    AudioCodec inCodec
);
To
OSStatus AudioCodecReset (
    AudioCodec _Nonnull inCodec
);

Declaration
From
OSStatus AudioCodecSetProperty (
    AudioCodec inCodec,
    AudioCodecPropertyID inPropertyID,
    UInt32 inPropertyDataSize,
    const void *inPropertyData
);
To
OSStatus AudioCodecSetProperty (
    AudioCodec _Nonnull inCodec,
    AudioCodecPropertyID inPropertyID,
    UInt32 inPropertyDataSize,
    const void * _Nonnull inPropertyData
);

Declaration
From
OSStatus AudioCodecUninitialize (
    AudioCodec inCodec
);
To
OSStatus AudioCodecUninitialize (
    AudioCodec _Nonnull inCodec
);

Deprecation
From--
ToOS X 10.11

AudioComponent.h

Declaration
From
OSStatus AudioComponentCopyConfigurationInfo (
    AudioComponent inComponent,
    CFDictionaryRef *outConfigurationInfo
);
To
OSStatus AudioComponentCopyConfigurationInfo (
    AudioComponent _Nonnull inComponent,
    CFDictionaryRef  _Nullable * _Nonnull outConfigurationInfo
);

Declaration
From
OSStatus AudioComponentCopyName (
    AudioComponent inComponent,
    CFStringRef *outName
);
To
OSStatus AudioComponentCopyName (
    AudioComponent _Nonnull inComponent,
    CFStringRef  _Nullable * _Nonnull outName
);

Declaration
From
UInt32 AudioComponentCount (
    const AudioComponentDescription *inDesc
);
To
UInt32 AudioComponentCount (
    const AudioComponentDescription * _Nonnull inDesc
);

Declaration
From
AudioComponent AudioComponentFindNext (
    AudioComponent inComponent,
    const AudioComponentDescription *inDesc
);
To
AudioComponent _Nullable AudioComponentFindNext (
    AudioComponent _Nullable inComponent,
    const AudioComponentDescription * _Nonnull inDesc
);

Declaration
From
OSStatus AudioComponentGetDescription (
    AudioComponent inComponent,
    AudioComponentDescription *outDesc
);
To
OSStatus AudioComponentGetDescription (
    AudioComponent _Nonnull inComponent,
    AudioComponentDescription * _Nonnull outDesc
);

Declaration
From
OSStatus AudioComponentGetVersion (
    AudioComponent inComponent,
    UInt32 *outVersion
);
To
OSStatus AudioComponentGetVersion (
    AudioComponent _Nonnull inComponent,
    UInt32 * _Nonnull outVersion
);

Declaration
From
Boolean AudioComponentInstanceCanDo (
    AudioComponentInstance inInstance,
    SInt16 inSelectorID
);
To
Boolean AudioComponentInstanceCanDo (
    AudioComponentInstance _Nonnull inInstance,
    SInt16 inSelectorID
);

Declaration
From
OSStatus AudioComponentInstanceDispose (
    AudioComponentInstance inInstance
);
To
OSStatus AudioComponentInstanceDispose (
    AudioComponentInstance _Nonnull inInstance
);

Declaration
From
AudioComponent AudioComponentInstanceGetComponent (
    AudioComponentInstance inInstance
);
To
AudioComponent _Nonnull AudioComponentInstanceGetComponent (
    AudioComponentInstance _Nonnull inInstance
);

Declaration
From
OSStatus AudioComponentInstanceNew (
    AudioComponent inComponent,
    AudioComponentInstance *outInstance
);
To
OSStatus AudioComponentInstanceNew (
    AudioComponent _Nonnull inComponent,
    AudioComponentInstance  _Nullable * _Nonnull outInstance
);

Declaration
From
AudioComponent AudioComponentRegister (
    const AudioComponentDescription *inDesc,
    CFStringRef inName,
    UInt32 inVersion,
    AudioComponentFactoryFunction inFactory
);
To
AudioComponent _Nonnull AudioComponentRegister (
    const AudioComponentDescription * _Nonnull inDesc,
    CFStringRef _Nonnull inName,
    UInt32 inVersion,
    AudioComponentFactoryFunction _Nonnull inFactory
);

Introduction
FromOS X 10.7
ToOS X 10.8

AudioOutputUnit.h

Added #def AudioUnit_AudioOutputUnit_h
Declaration
From
OSStatus AudioOutputUnitStart (
    AudioUnit ci
);
To
OSStatus AudioOutputUnitStart (
    AudioUnit _Nonnull ci
);

Declaration
From
OSStatus AudioOutputUnitStop (
    AudioUnit ci
);
To
OSStatus AudioOutputUnitStop (
    AudioUnit _Nonnull ci
);

AudioUnitCarbonView.h

Added #def AudioUnit_AudioUnitCarbonView_h
Modified AudioUnitCarbonViewCreate()
Deprecation
From--
ToOS X 10.11

AudioUnitParameters.h

Added #def AudioUnit_AudioUnitParameters_h

AudioUnitProperties.h

Deprecation
From--
ToOS X 10.11

IntroductionDeprecation
FromOS X 10.5--
ToOS X 10.7OS X 10.11

IntroductionDeprecation
FromOS X 10.2--
ToOS X 10.7OS X 10.11

IntroductionDeprecation
FromOS X 10.3--
ToOS X 10.7OS X 10.11

IntroductionDeprecation
FromOS X 10.2--
ToOS X 10.7OS X 10.11

Deprecation
From--
ToOS X 10.11

IntroductionDeprecation
FromOS X 10.2--
ToOS X 10.7OS X 10.11

IntroductionDeprecation
FromOS X 10.5--
ToOS X 10.7OS X 10.11

Deprecation
From--
ToOS X 10.9

AUParameters.h (Added)

MusicDevice.h

Added #def AudioUnit_MusicDevice_h
Declaration
From
OSStatus MusicDeviceMIDIEvent (
    MusicDeviceComponent inUnit,
    UInt32 inStatus,
    UInt32 inData1,
    UInt32 inData2,
    UInt32 inOffsetSampleFrame
);
To
OSStatus MusicDeviceMIDIEvent (
    MusicDeviceComponent _Nonnull inUnit,
    UInt32 inStatus,
    UInt32 inData1,
    UInt32 inData2,
    UInt32 inOffsetSampleFrame
);

Declaration
From
OSStatus MusicDevicePrepareInstrument (
    MusicDeviceComponent inUnit,
    MusicDeviceInstrumentID inInstrument
);
To
OSStatus MusicDevicePrepareInstrument (
    MusicDeviceComponent _Nonnull inUnit,
    MusicDeviceInstrumentID inInstrument
);

Declaration
From
OSStatus MusicDeviceReleaseInstrument (
    MusicDeviceComponent inUnit,
    MusicDeviceInstrumentID inInstrument
);
To
OSStatus MusicDeviceReleaseInstrument (
    MusicDeviceComponent _Nonnull inUnit,
    MusicDeviceInstrumentID inInstrument
);

Declaration
From
OSStatus MusicDeviceStartNote (
    MusicDeviceComponent inUnit,
    MusicDeviceInstrumentID inInstrument,
    MusicDeviceGroupID inGroupID,
    NoteInstanceID *outNoteInstanceID,
    UInt32 inOffsetSampleFrame,
    const MusicDeviceNoteParams *inParams
);
To
OSStatus MusicDeviceStartNote (
    MusicDeviceComponent _Nonnull inUnit,
    MusicDeviceInstrumentID inInstrument,
    MusicDeviceGroupID inGroupID,
    NoteInstanceID * _Nonnull outNoteInstanceID,
    UInt32 inOffsetSampleFrame,
    const MusicDeviceNoteParams * _Nonnull inParams
);

Declaration
From
OSStatus MusicDeviceStopNote (
    MusicDeviceComponent inUnit,
    MusicDeviceGroupID inGroupID,
    NoteInstanceID inNoteInstanceID,
    UInt32 inOffsetSampleFrame
);
To
OSStatus MusicDeviceStopNote (
    MusicDeviceComponent _Nonnull inUnit,
    MusicDeviceGroupID inGroupID,
    NoteInstanceID inNoteInstanceID,
    UInt32 inOffsetSampleFrame
);

Declaration
From
OSStatus MusicDeviceSysEx (
    MusicDeviceComponent inUnit,
    const UInt8 *inData,
    UInt32 inLength
);
To
OSStatus MusicDeviceSysEx (
    MusicDeviceComponent _Nonnull inUnit,
    const UInt8 * _Nonnull inData,
    UInt32 inLength
);