Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка RootDomain.h

Опции
Развертывание Target:

На этой странице

Ссылка RootDomain.h

Включенные заголовки

  • <IOKit/IOService.h>

  • <IOKit/pwr_mgt/IOPM.h>

  • <IOKit/IOBufferMemoryDescriptor.h>

Функции

  • Скопируйте текущую стоимость для премьер-министра, устанавливающего. Возвращает OSNumber или OSData в зависимости от установки.

    Объявление

    Objective C

    OSObject * copyPMSetting( OSSymbol *whichSetting );

    Параметры

    whichSetting

    Имя желаемой установки.

    Возвращаемое значение

    OSObject оценивают, если допустимый, NULL иначе.

  • Создает утверждение для влияния на поведение питания системы.

    Объявление

    Objective C

    IOPMDriverAssertionID createPMAssertion( IOPMDriverAssertionType whichAssertionsBits, IOPMDriverAssertionLevel assertionLevel, IOService *ownerService, const char *ownerDescription);

    Параметры

    whichAssertionBits

    Битовое поле указывает утверждение, что вызывающая сторона запрашивает.

    assertionLevel

    Целое число, детализирующее начальный уровень утверждения, kIOPMDriverAssertionLevelOn или kIOPMDriverAssertionLevelOff.

    ownerService

    Указатель на класс вызывающей стороны IOService, для отслеживания.

    ownerDescription

    Строка обратного DNS, описывающая идентификационные данные и причину вызывающей стороны.

    Возвращаемое значение

    На успехе, возвращает новое утверждение типа IOPMDriverAssertionID

  • Объявление

    Objective C

    IOPMDriverAssertionLevel getPMAssertionLevel( IOPMDriverAssertionType whichAssertionBits);

    Параметры

    whichAssertionBits

    Биты, определяющие утверждение или утверждения вызывающая сторона, интересуются уровнем. Если в сомнении, передайте kIOPMDriverAssertionCPUBit как параметр.

    Возвращаемое значение

    Возвраты kIOPMDriverAssertionLevelOff или kIOPMDriverAssertionLevelOn указание уровней указанного утверждения, при наличии. Если утверждения не поддерживаются на этой машине или не распознаны OS, результат не определен.

    Обсуждение

    Возвраты kIOPMDriverAssertionLevelOff или kIOPMDriverAssertionLevelOn. Если все утверждения активны, если многократные утверждения указаны в битовом поле, только kIOPMDriverAssertionLevelOn возвратов.

  • Регистр для обратных вызовов на изменениях в определенных настройках PM.

    Объявление

    Objective C

    IOReturn registerPMSettingController( const OSSymbol *settings[], IOPMSettingControllerCallback callout, OSObject *target, uintptr_t refcon, OSObject **handle); // out param

    Параметры

    settings

    NULL завершил массив струн до, каждой строки для премьер-министра, устанавливающего, которым вызывающая сторона интересуется и хочет получить обратные вызовы для.

    callout

    C функция ptr или функция членства бросают как таковой.

    target

    Цель обратного вызова, обычно 'это'

    refcon

    Будет передан вызывающей стороне в обратном вызове; для использования вызывающей стороны.

    handle

    Вызывающая сторона должна сохранить OSObject *, возвратился сюда. Если не-NULL, дескриптор будет иметь сохранить количество 1 по возврату. Для вычеркивания из списка передайте unregisterPMSettingController ()

    Возвращаемое значение

    kIOReturnSuccess на успехе.

  • Регистр для обратных вызовов на изменениях в определенных настройках PM.

    Объявление

    Objective C

    IOReturn registerPMSettingController( const OSSymbol *settings[], uint32_t supportedPowerSources, IOPMSettingControllerCallback callout, OSObject *target, uintptr_t refcon, OSObject **handle); // out param

    Параметры

    settings

    NULL завершил массив струн до, каждой строки для премьер-министра, устанавливающего, которым вызывающая сторона интересуется и хочет получить обратные вызовы для.

    supportedPowerSources

    битовое поле, указывающее, какие источники питания эти настройки поддерживаются для (kIOPMSupportedOnAC, и т.д.)

    callout

    C функция ptr или функция членства бросают как таковой.

    target

    Цель обратного вызова, обычно 'это'

    refcon

    Будет передан вызывающей стороне в обратном вызове; для использования вызывающей стороны.

    handle

    Вызывающая сторона должна сохранить OSObject *, возвратился сюда. Если не-NULL, дескриптор будет иметь сохранить количество 1 по возврату. Для вычеркивания из списка передайте unregisterPMSettingController ()

    Возвращаемое значение

    kIOReturnSuccess на успехе.

  • Удаляет утверждение для влияния на поведение питания системы.

    Объявление

    Objective C

    IOReturn releasePMAssertion( IOPMDriverAssertionID releaseAssertion);

    Возвращаемое значение

    На успехе, возвращает новое утверждение типа IOPMDriverAssertionID *

  • Другие драйверы могут сообщить IOPMrootDomain системных событий PM

    Объявление

    Objective C

    IOReturn systemPowerEventOccurred( const OSSymbol *event, uint32_t intValue );

    Параметры

    event

    OSSymbol описание типа события питания.

    value

    32-разрядное целочисленное значение связалось с событием.

    shouldUpdate

    указывает, должен ли корневой домен отправить уведомление заинтересованным сторонам. Передайте ложь при вызове systemPowerEventOccurred несколько раз по очереди; и передайте истину только последнему invocatino.

    Возвращаемое значение

    kIOReturnSuccess на успехе

    Обсуждение

    systemPowerEventOccurred является более богатой альтернативой receivePowerNotification (), Только kexts находившийся в собственности Apple должен иметь причину вызвать systemPowerEventOccurred.

Типы данных

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Объявление

    Objective C

    /*! IOPMDriverAssertionType */ typedef uint64_t IOPMDriverAssertionType;

    Обсуждение

    Типы для Утверждений PM Для создания, выпуска и получения уровней утверждения PM.

    Оператор импорта

    Objective C

    #include <RootDomain.h>;

    Доступность

    Доступный в OS X v10.7 и позже.