changerClassInitialize 函数 (mcd.h)

  • 项目

ChangerClassInitialize 例程初始化驱动程序。

语法

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

参数

[in] DriverObject

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

[in] RegistryPath

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

ChangerInitData

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

返回值

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

注解

ChangerClassInitialize 是一种变更类驱动程序例程，微类驱动程序可以在 Microsoft Windows XP 和更高版本的操作系统中调用该例程。

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

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

要求

要求 值
目标平台 桌面
标头 mcd.h (包括 Mcd.h、Ntddchgr.h)
Library Mcd.lib

另请参阅

MCD_INIT_DATA

RtlZeroMemory