DRCoreNotifications.h Reference

Declared in
DRCoreNotifications.h

Overview

Disc Recording notification interfaces.

Included Headers

  • <DiscRecording/DRCoreObject.h>

  • <AvailabilityMacros.h>

Functions

See the Overview section above for header-level documentation.

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
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h

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
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h

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
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h

DRNotificationCenterGetTypeID

Returns the type identifier of all DRNotificationCenter instances.

extern CFTypeID DRNotificationCenterGetTypeID(
   void) ;
Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h

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
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h

Callbacks

See the Overview section above for header-level documentation.

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.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h

Data Types

See the Overview section above for header-level documentation.

DRNotificationCenterRef

The type of a reference to a DRNotificationCenter object.

typedef struct __DRNotificationCenter* DRNotificationCenterRef;
Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreNotifications.h