Поделиться через


Общие сведения о стандартных процедурах драйвера

Каждый драйвер в режиме ядра создается на основе набора системных стандартных процедур драйвера. Драйверы в режиме ядра обрабатывают пакеты запросов ввода-вывода (IRP) в рамках этих стандартных процедур, вызывая предоставляемые системой процедуры поддержки драйверов.

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

Стандартные процедуры драйвера можно разделить на две группы: те, которые должны быть у каждого драйвера в режиме ядра, и те, которые являются необязательными в зависимости от типа драйвера и расположения в стеке устройств.

В следующей таблице перечислены необходимые стандартные подпрограммы.

Обязательные стандартные подпрограммы драйвера Назначение Где описано
DriverEntry Инициализирует драйвер и его объект драйвера. Написание процедуры DriverEntry
AddDevice Инициализирует устройства и создает объекты устройств. Написание процедуры AddDevice
Подпрограммы диспетчеризации Получение и обработка IRP. Написание процедур диспетчеризации
Выгрузить Освобождение системных ресурсов, полученных драйвером. Написание подпрограммы выгрузки

В следующей таблице перечислены несколько необязательных процедур.

Необязательные стандартные процедуры драйвера Назначение Где описано
Повторная инициализация Завершает инициализацию драйвера, если driverEntry не удается. Написание подпрограммы повторной инициализации
StartIo Запускает операцию ввода-вывода на физическом устройстве. Написание процедуры StartIo
Подпрограмма службы прерываний Сохраняет состояние устройства при прерывании. Написание ISR
Отложенные вызовы процедур Завершает обработку прерывания устройства после того, как ISR сохранит состояние устройства. Объекты DPC и DPC
SynchCritSection Синхронизирует доступ к данным драйвера. Использование критических разделов
AdapterControl Инициирует операции DMA. Объекты адаптера и DMA
IoCompletion Завершает обработку IRP драйвером. Завершение IRP
Отмена Отменяет обработку IRP драйвером. Отмена IRP
CustomTimerDpc, IoTimer Синхронизация и синхронизация событий. Методы синхронизации

Текущий IRP и целевой объект устройства являются входными параметрами для многих стандартных подпрограмм. Каждый драйвер обрабатывает каждую IRP поэтапно с помощью набора стандартных процедур.

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