ADC Home > Reference Library > Reference > Audio > Carbon > Disc Recording Framework Reference

DRCoreNotifications.h

Includes:

Overview

Disc Recording notification interfaces.

Functions

DRNotificationCenterAddObserver: Adds an observer callback for a notification center.
DRNotificationCenterCreate: Creates a notification center that can be used to register for and receive asyncronous notifications.
DRNotificationCenterCreateRunLoopSource: Creates a run-loop source object for a notification center.
DRNotificationCenterGetTypeID: Returns the type identifier of all DRNotificationCenter instances.
DRNotificationCenterRemoveObserver: Removes an observer callback from a notification center.

DRNotificationCenterAddObserver

Adds an observer callback for a notification center.

extern void DRNotificationCenterAddObserver(
    DRNotificationCenterRef center,
    const void *observer,
    DRNotificationCallback callback,
    CFStringRef name,
    DRTypeRef object) ;

Parameters

center: The notification center that the new observer callback is for.
observer: The observer callback to add, which gets passed to the callback.
callback: The observer callback to use for notification delivery.
name: The notification name for adding the observer.
object: The object the notification name is associated with.

Availability: Introduced in Mac OS X v10.2

DRNotificationCenterCreate

Creates a notification center that can be used to register for and receive asyncronous notifications.

extern DRNotificationCenterRef DRNotificationCenterCreate(
    void) ;

Return Value

Returns reference to a new DRNotificationCenter object.

Availability: Introduced in Mac OS X v10.2

DRNotificationCenterCreateRunLoopSource

Creates a run-loop source object for a notification center.

extern CFRunLoopSourceRef DRNotificationCenterCreateRunLoopSource(
    DRNotificationCenterRef center) ;

Parameters

center: The notification center that the new run-loop source object is for.

If this parameter is not a valid DRNotificationCenter object, the behavior is undefined.

Return Value

Returns a reference to a CFRunLoopSource object.

Availability: Introduced in Mac OS X v10.2

DRNotificationCenterGetTypeID

Returns the type identifier of all DRNotificationCenter instances.

extern CFTypeID DRNotificationCenterGetTypeID(
    void) ;

Availability: Introduced in Mac OS X v10.2

DRNotificationCenterRemoveObserver

Removes an observer callback from a notification center.

extern void DRNotificationCenterRemoveObserver(
    DRNotificationCenterRef center,
    const void *observer,
    CFStringRef name,
    DRTypeRef object) ;

Parameters

center: The notification center that the observer callback will be removed from.
observer: The observer callback to remove.
name: The notification name for removing the observer callback.
object: The object the notification name is associated with.

Availability: Introduced in Mac OS X v10.2

Typedefs

DRNotificationCallback

Delivers a notification.

typedef void ( *DRNotificationCallback)(
    DRNotificationCenterRef center,
    void *observer,
    CFStringRef name,
    DRTypeRef object,
    CFDictionaryRef info);

Parameters

center
The notification center that this callback is associated with.

observer
The observer specified when this callback was added.

name
The notification name.

object
The object that this notification is associated with, or NULL when there is no associated object.

info
A dictionary object containing additional notification information, or NULL when there is no associated object.

DRNotificationCenterRef

The type of a reference to a DRNotificationCenter object.

typedef struct __DRNotificationCenter* DRNotificationCenterRef;

Did this document help you?

Yes: Tell us what works for you.

It’s good, but: Report typos, inaccuracies, and so forth.

It wasn’t helpful: Tell us what would have helped.

Last Updated: 2008-04-01