Функция ChangerClassInitialize (mcd.h)
Программа ChangerClassInitialize инициализирует драйвер.
Синтаксис
NTSTATUS ChangerClassInitialize(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPath,
PMCD_INIT_DATA ChangerInitData
);
Параметры
[in] DriverObject
Указатель на объект драйвера миникласса для изменения. Этот параметр передается в DriverEntry драйвера miniclass. Формат этого объекта зависит от операционной системы и не должен интерпретироваться драйвером миникласса.
[in] RegistryPath
Указатель на путь реестра для драйвера миникласса для средства изменения. Это также передается в качестве параметра в подпрограмму DriverEnt ry драйвера miniclass. Формат этой операционной системы зависит от операционной системы и не должен интерпретироваться драйвером миникласса.
ChangerInitData
Указатель на структуру MCD_INIT_DATA, содержащую сведения о драйвере miniclass, такие как точки входа для подпрограмм обработки команд драйвера миникласса.
Возвращаемое значение
ChangerClassInitialize возвращает значение, указывающее на успешность или сбой инициализации драйвера. Если инициализация выполнена успешно, ChangerClassInitialize возвращает STATUS_SUCCESS. В противном случае ChangerClassInitialize возвращает соответствующее сообщение об ошибке. Мини-drivers должны не интерпретировать это значение ошибки, но просто возвращать это значение из подпрограммы driverEntry DriverEntry.
Замечания
ChangerClassInitialize — это подпрограмма драйвера класса изменений, которую драйверы миниклассов могут вызывать в Microsoft Windows XP и более поздних операционных системах.
Драйверы миниклассов changer вызывают ChangerClassInitialize из подпрограмм DriverEntry для инициализации драйвера. ChangerClassInitialize выполняет многие задачи, ранее выполняемые драйвером класса изменений DriverEntry подпрограммы, такие как регистрация подпрограмм отправки драйвера miniclass. Он выделяет расширение объекта драйвера и копирует данные, содержащиеся в MCDInitData в расширение объекта драйвера, а также другие данные инициализации, такие как путь реестра драйвера и указатели на определенные подпрограммы драйвера класса изменений, относящиеся к операционной системе.
Драйверы миникласса changer должны выделить структуру MCD_INIT_DATA, ноль структуры путем вызова RtlZeroMemory, а затем назначить значения соответствующим членам перед передачей адреса структуры в ChangerClassInitialize с помощью параметра MCDInitData.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | mcd.h (включая Mcd.h, Ntddchgr.h) |
| библиотеки | Mcd.lib |