Функция ChangerClassInitialize (mcd.h)

Статья
02/29/2024

Подпрограмма 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 .

Драйверы мини-класса changer вызывают ChangerClassInitialize из подпрограмм DriverEntry , чтобы инициализировать драйвер. ChangerClassInitialize выполняет множество задач, которые ранее выполнялись подпрограммой DriverEntry драйвера класса changer, например регистрацию подпрограмм диспетчеризации драйвера мини-класса. Он выделяет расширение объекта драйвера и копирует данные, содержащиеся в MCDInitData , в расширение объекта драйвера вместе с другими данными инициализации, такими как путь к реестру драйвера и указатели на определенные подпрограммы драйвера класса изменения, относящиеся к операционной системе.

Драйверы мини-класса средства изменения должны выделить MCD_INIT_DATA структуру, ноль структуры путем вызова RtlZeroMemory, а затем назначить значения соответствующим членам, прежде чем передавать адрес структуры в ChangerClassInitialize с помощью параметра MCDInitData .

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	mcd.h (включая Mcd.h, Ntddchgr.h)
Библиотека	Mcd.lib

См. также раздел

MCD_INIT_DATA

RtlZeroMemory

Share via