Mac Developer Library

Developer

IONotifier Class Reference

Options
Deployment Target:

On This Page

IONotifier

An abstract base class defining common methods for controlling a notification request.

IOService notification requests are represented as implementations of the IONotifier object. It defines methods to enable, disable and remove notification requests. These actions are synchronized with invocations of the notification handler, so removing a notification request will guarantee the handler is not being executed.

  • Disables the notification request.

    Declaration

    virtual bool disable() = 0;

    Return Value

    Returns the previous enable state of the IONotifier.

    Discussion

    Disables the notification request. This method is synchronous with any handler invocations, so when this method returns its guaranteed the handler will not be in entered.

  • Sets the enable state of the notification request.

    Declaration

    virtual void enable( bool was ) = 0;

    Parameters

    was

    The enable state of the notifier to restore.

    Discussion

    Restores the enable state of the notification request, given the previous state passed in.

  • Removes the notification request and releases it.

    Declaration

    virtual void remove() = 0;

    Discussion

    Removes the notification request and release it. Since creating an IONotifier instance will leave it with a retain count of one, creating an IONotifier and then removing it will destroy it. This method is synchronous with any handler invocations, so when this method returns its guaranteed the handler will not be in entered.