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