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作时,该函数针对 ControllerConfiguration 结构中指定的每个 NumberOfChannels 调用一次,AtaAdapterControl 返回。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | mcd.h(包括 Ntddk.h、Mcd.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |