Теперь, когда у нас уже есть представление о внутреннем устройстве объектов

и связанных с ними структурах данных, самое время рассмотреть экспортируемые интерфейсы, которые дают возможность управлять объектами и выполнять с ними другие манипуляции. В основном, разработчикам драйверов непосредственно не приходится иметь дело с объектами . Структуры встраиваются в некоторые специальные структуры данных (как это было в примере структуры устройства посимвольного ввода-вывода) и управляются "за кадром" с помощью соответствующей подсистемы драйверов. Тем не менее, объекты не всегда могут оставаться невидимыми, иногда с ними приходится иметь дело, как при разработке кода драйверов, так и при разработке кода управления подсистемами ядра.

Первый шаг при работе с объектами

— это их декларация и инициализация. Инициализируются объекты с помощью функции , которая определена в файле следующим образом.

Единственным параметром этой функции является объект

, который необходимо проинициализировать. Перед вызовом этой функции область памяти, в которой хранится объект, должна быть заполнена нулевыми значениями. Обычно это делается при инициализации большой структуры данных, в которую встраивается объект . В других случаях просто необходимо вызвать функцию .

После заполнения нулями безопасным будет инициализация полей

и , как показано в следующем примере.

После инициализации необходимо установить имя объекта с помощью функции

, которая имеет следующий прототип.

Эта функция принимает переменное количество параметров, по аналогии с функциями

и . Как уже было сказано, на имя объекта указывает поле структуры . Если это имя достаточно короткое, то оно хранится в статически выделенном массиве , поэтому есть смысл без необходимости не указывать длинные имена.

После того как для объекта выделена память и объекту присвоено имя, нужно установить значение его поля

, а также опционально поле . Последнее необходимо делать только в том случае, если множество не предоставляет типа для данного объекта, в противном случае значение поля , которое указано в структуре , имеет преимущество. Если интересно, почему объекты имеют свое поле , то добро пожаловать в клуб!

Одно из главных свойств, которое реализуется с помощью объектов

, — это унифицированная система поддержки счетчиков ссылок. После инициализации количество ссылок на объект устанавливается равным единице. Пока значение счетчика ссылок на объект не равно нулю, объект существует в памяти, и говорят, что он захвачен (pinned, буквально, пришпилен). Любой код, который работает с объектом, вначале должен увеличить значение счетчика ссылок. После того как код закончил работу с объектом, он должен уменьшить значение счетчика ссылок. Увеличение значения счетчика называют захватом (getting), уменьшение — освобождением (putting) ссылки на объект. Когда значение счетчика становится равным нулю, объект может быть уничтожен, а занимаемая им память освобождена.

Увеличение значения счетчика ссылок выполняется с помощью функции

.

Эта функция возвращает указатель на объект

в случае успеха и значение в случае ошибки.

Уменьшение значения счетчика ссылок выполняется с помощью функции

.

Если значение счетчика ссылок объекта, который передается в качестве параметра, становится равным нулю, то вызывается функция, на которую указывает указатель

поля этого объекта.

Внутреннее представление счетчика ссылок выполнено с помощью структуры

, которая определена в файле следующим образом.

Единственное поле этой структуры — атомарная переменная, в которой хранится значение счетчика ссылок. Структура используется просто для того, чтобы выполнять проверку типов. Чтобы воспользоваться структурой

, необходимо ее инициализировать с помощью функции .