ADC Home > Reference Library > Reference > Audio > Carbon > Disc Recording Framework Reference
|
DRCoreObject.h |
Includes: | <CoreServices/CoreServices.h> <AvailabilityMacros.h> |
Base types for Disc Recording Core object references.
These types are for use in polymorphic functions and as general-purpose type identifiers.
DRCopyLocalizedStringForValue |
Maps a framework key to a localized string.
extern CFStringRef DRCopyLocalizedStringForValue( CFStringRef value) ;
value
A value of type CFStringRef which contains the localized string.
If a localized string cannot be found, this function returns the specified value as a string
DRGetRefCon |
Gets the Disc Recording object's reference context value.
extern void* DRGetRefCon( DRTypeRef ref) ;
ref
The value currently stored in the Disc Recording object's reference context.
DRSetRefCon |
Sets the Disc Recording object's reference context value.
extern void DRSetRefCon( DRTypeRef ref, void *refCon, const DRRefConCallbacks *callbacks) ;
ref
refCon
callbacks
kDRRefConCFTypeCallbacks |
A predefined DRRefConCallbacks structure containing a set of callbacks appropriate for use when the reference context is a CFType object.
extern const DRRefConCallbacks kDRRefConCFTypeCallbacks;
DRRefConReleaseCallback |
A callback used by a Disc Recording object to relinquish ownership of its refCon (reference context) data.
typedef void ( *DRRefConReleaseCallback)( const void *refCon);
If you name your function MyDRRefConReleaseCallback, you would
declare it like this:
void MyDRRefConReleaseCallback (void *refCon);
DRRefConRetainCallback |
A callback used by a Disc Recording object to obtain ownership of its refCon (reference context) data.
typedef const void* ( *DRRefConRetainCallback)( const void *refCon);
If you name your function MyDRRefConRetainCallback, you would
declare it like this:
void MyDRRefConRetainCallback (void *refCon);
DRTypeRef |
An untyped, generic reference to any Disc Recording object.
typedef CFTypeRef DRTypeRef;
DRTypeRef is one of the base types defined in Disc Recording, used as a
placeholder for parameter and return type in several polymorphic functions.
It is a generic object reference that can take a reference to any other
Disc Recording object.
DRRefConCallbacks |
Contains a set of callbacks for use by a Disc Recording object in managing its reference context.
struct DRRefConCallbacks { unsigned long version; DRRefConRetainCallback retain; DRRefConReleaseCallback release; };
version
- The version of this structure. The value must be a known version, or zero.
retain
- An optional callback used by a Disc Recording object to retain its reference context. When NULL, the Disc Recording object will not retain the reference context when set.
release
- An optional callback used by a Disc Recording object to remove a retain previously added for its reference context. When NULL, the Disc Recording objecting will not release its reference context when the object is destroyed or when a new reference context value is set.
|