Important Change - ParameterNames
Important Change - ParameterNames
- Subject: Important Change - ParameterNames
- From: Bill Stewart <email@hidden>
- Date: Mon, 18 Aug 2003 21:11:10 -0700
There is an important change from the previous post about parameter
names - the two structs that are used when retrieving parameter names
(like short names or names of clumps)
This is how they should look:
kAudioUnitProperty_ParameterValueName -> AudioUnitParameterValueName
typedef struct AudioUnitParameterValueName {
AudioUnitParameterID inParamID;
Float32 *inValue;
CFStringRef outName;
} AudioUnitParameterValueName;
Get
- should be released by caller
(So, if AU has static CFStrings for these, it should call CFRetain
on these names before returning them)
The (CFStringRef outName) field is a CFStringRef, not CFStringRef*
as previously stated)
(An important note about the usage of this struct, if the AU does not
have a name for the particular value it is returning, it is
*responsible* for setting the outName field to NULL) It is *not* an
error to not retrieve a name for a parameter value, so the host will
use this field to determine if the parameter has a name, or it can
display the value of the parameter
And:
kAudioUnitProperty_ParameterIDName
kAudioUnitProperty_ParameterClumpName
These two properties use
typedef struct AudioUnitParameterNameInfo {
UInt32 inID;
SInt32 inDesiredLength;
CFStringRef outName;
} AudioUnitParameterIDName;
Get
Client should release string after using it.
(So, if AU has static CFStrings for these, it should call CFRetain
on these names before returning them)
The (CFStringRef outName) field is a CFStringRef, not CFStringRef*
as previously stated)
Apologies for any confusion
Bill
--
mailto:email@hidden
tel: +1 408 974 4056
________________________________________________________________________
__
"Much human ingenuity has gone into finding the ultimate Before.
The current state of knowledge can be summarized thus:
In the beginning, there was nothing, which exploded" - Terry Pratchett
________________________________________________________________________
__
_______________________________________________
coreaudio-api mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/coreaudio-api
Do not post admin requests to the list. They will be ignored.