ADC Home > Reference Library > Reference > Darwin > Kernel Framework Reference

---

IONotifier

Overview

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

Discussion

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.

---

Functions

disable

Disables the notification request.

enable

Sets the enable state of the notification request.

remove

Removes the notification request and releases it.

---

disable

---

Disables the notification request.

public

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.

---

enable

---

Sets the enable state of the notification request.

public

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.

---

remove

---

Removes the notification request and releases it.

public

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.

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-12-19