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 |