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.
DRNotificationCenterRef: The type of a reference to a DRNotificationCenter object.

DRNotificationCallback

Delivers a notification.

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

Fields

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;

Last Updated: 2009-08-12