Операционная система ЗОСРВ «Нейтрино» > Руководство разработчика > Основные принципы системной разработки > Разработка драйверов и драйверные библиотеки > Драйверные библиотеки > Библиотека разработки драйверов символьных устройств (libio-char) > Библиотека libio-char.a > iochar_regdrv_power()

iochar_regdrv_power()

Регистрация в качестве драйвера с поддержкой управления питанием

Прототип:

#include <sys/io-char.h>
 
int iochar_regdrv_power( TTYDEV *dev,
                         TTYINITPOWER *init,
                         unsigned flags );

Аргументы:

dev

Указатель на структуру TTYDEV, представляющую конкретное устройство, на котором были получены данные.

init

Указатель на структуру TTYINITPOWER, содержащую информацию о регистрации устройства с поддержкой управления питанием.

flags

Флаги управления питанием. Один из:

PWR_INIT_DRVREG: Регистрация как устройства с управлением питанием.
PWR_INIT_DRVPSTORE: Драйверу нужен собственный объект постоянного хранения.
PWR_INIT_DRVSAVE: Драйвер хочет сохранять данные для HWVOL или NORAM.
PWR_INIT_DRVOVERRIDE: Драйвер берет на себя все функциональные обязанности по управлению питанием.
PWR_INIT_DRVNOFLOWCTL: Драйвер должен задерживаться перед отключением для контроля потока.
PWR_INIT_NOPMM: Указывает, что при инициализации диспетчер питания не запущен.
PWR_WAITING_DRAIN: Изменение питания ожидает опустошения устройства.
PWR_FLOW_PAGED: Устройство аппаратно или программно странично из-за питания.
PWR_EVENT_DEVCTL: Проверяет блокирующую очередь devctl().
PWR_EVENT_DEVWAKEUP: Устройство хочет выйти из режима ожидания из-за внешнего события, например, события пробуждения устройства (это НЕ пробуждение ЦП).
PM_MODE_HW_NONE: Режим питания не поддерживает доступ к оборудованию.
PM_MODE_HW_TX: Режим питания позволяет передачу данных.
PM_MODE_HW_RX: Режим питания позволяет прием данных.
PM_MODE_HW_CTRL: Режим питания позволяет управление линиями RTS/DTR.
PM_MODE_HW_REGREAD: Режим питания позволяет чтение регистров.
PM_MODE_HW_REGWRITE: Режим питания позволяет запись регистров.
PM_MODE_HW_ALL: Режим питания позволяет полный доступ к устройству.
PM_MODE_HW_RXTX: Режим питания позволяет передачу и прием данных.
PM_MODE_HW_REG: Режим питания позволяет чтение и запись регистров.
PM_MODE_HW_DRAIN: Режим питания позволяет чтение регистров и передачу данных.
PM_MODE_HW_OFF: В режиме OFF доступ к оборудованию должен быть запрещен.
PM_MODE_HW_ACTIVE: ACTIVE-режимы должны позволять полный доступ к оборудованию.

Эта функция регистрирует драйвер в io-char поддерживающий управление питанием. Если вы разрабатываете драйвер с поддержкой управления питанием, вызовите iochar_regdrv_power() перед вызовом ttc(TTC_INIT_POWER, ...).

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

0: Успешное завершение.
-1: Произошла ошибка.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока: Нет
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Нет

Тематические ссылки:

TTYDEV, ttc(), tti(), tto()

Предыдущий раздел: Библиотека разработки драйверов символьных устройсв