ChangerClassInitialize 函数 （mcd.h）

ChangerClassInitialize 例程初始化驱动程序。

语法

NTSTATUS ChangerClassInitialize(
  [in] PDRIVER_OBJECT  DriverObject,
  [in] PUNICODE_STRING RegistryPath,
       PMCD_INIT_DATA  ChangerInitData
);

参数

[in] DriverObject

指向 changer miniclass 驱动程序对象的指针。 这作为参数传递给微型类驱动程序的 DriverEntry 例程。 此对象的格式特定于作系统，不应由微型类驱动程序解释。

[in] RegistryPath

指向 changer miniclass 驱动程序的注册表路径的指针。 这也作为参数传递给微型类驱动程序的 DriverEntry 例程。 此格式是特定于作系统的，不应由微型类驱动程序解释。

ChangerInitData

指向包含微型类驱动程序特定信息的 MCD_INIT_DATA 结构的指针，例如 changer miniclass 驱动程序命令处理例程的入口点。

返回值

ChangerClassInitialize 返回指示驱动程序初始化成功或失败的值。 如果初始化成功，ChangerClassInitialize 返回STATUS_SUCCESS。 否则，ChangerClassInitialize 返回相应的错误消息。 微型驱动程序应 不 解释此错误值，但应仅从其 DriverEntry 例程中返回此值。

言论

ChangerClassInitialize 是一个更改程序类驱动程序例程，微型类驱动程序可以在 Microsoft Windows XP 及更高版本的作系统中调用该例程。

Changer miniclass 驱动程序从其 DriverEntry 例程中调用 ChangerClassInitialize 来初始化驱动程序。 ChangerClassInitialize 执行更改程序类驱动程序 DriverEntry 例程（例如注册微型类驱动程序的调度例程）执行的许多任务。 它分配驱动程序对象扩展，并将 MCDInitData 中包含的数据复制到驱动程序对象扩展中，以及其他初始化数据，例如驱动程序的注册表路径和指向特定于作系统的某些 changer 类驱动程序例程的指针。

Changer miniclass 驱动程序必须分配一个 MCD_INIT_DATA 结构，通过调用 RtlZeroMemory，然后将结构地址传递给 ChangerClassInitialize，然后通过 MCDInitData 参数将结构地址传递给相应的成员。

要求

另请参阅

MCD_INIT_DATA

RtlZeroMemory