DriverEntry 函数 (mcd.h)

  • 项目

加载微型端口驱动程序时，将调用 DriverEntry 微型端口驱动程序例程。

注意 ATA 端口驱动程序和 ATA 微型端口驱动程序模型将来可能会更改或不可用。 建议改用 Storport 驱动程序 和 Storport 微型端口 驱动程序模型。
 

语法

NTSTATUS DriverEntry(
  [in] PDRIVER_OBJECT  DriverObject,
  [in] PUNICODE_STRING RegistryPath
);

参数

[in] DriverObject

指向当此例程调用 AtaPortInitializeEx 例程时用作第一个参数的不透明结构的指针。

[in] RegistryPath

指向不透明结构的指针，此例程调用 AtaPortInitializeEx 例程时用作第二个参数。

返回值

建议使用此例程的返回值来镜像 AtaPortInitializeEx 的返回值。

注解

DriverEntry 是在 ATA 微型端口驱动程序中调用的第一个函数。 ATA 微型端口驱动程序必须分配 IDE_CONTROLLER_INTERFACE 结构，对其进行初始化，并将其发送到 AtaPortInitializeEx。 ATA 微型端口驱动程序通过在 IDE_CONTROLLER_INTERFACE 结构中设置 ChannelExtensionSize 和 AtaChannelInitRoutine 入口点来指示其对 通道 接口的支持。 这会导致 ATA 端口驱动程序调用 AtaChannelInitRoutine 字段中指定的函数，该函数的 ChannelExtension 大小为 ChannelExtensionSize。 当 AtaAdapterControl 处理 IdeStart 操作时，对于由 AtaAdapterControl 返回的 ControllerConfiguration 结构中指定的每个 NumberOfChannels，该函数将调用一次。

要求

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

另请参阅

AtaAdapterControl

AtaPortInitializeEx