Функция 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 указывает на поддержку интерфейса канала, задав ChannelExtensionSize и точку входа ataChannelInitRoutine в структуре IDE_CONTROLLER_INTERFACE. Это приводит к вызову драйвера порта ATA, указанной в поле AtaChannelInitRoutine, которое имеет ChannelExtension ChannelExtensionSize. Функция вызывается один раз для каждого NumberOfChannels, указанного в структуре ControllerConfiguration, возвращаемой AtaAdapterControl, когда AtaAdapterControl обрабатывает действие IdeStart.

Требования

Требование Ценность
целевая платформа Настольный
заголовка mcd.h (include Ntddk.h, Mcd.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe

См. также

AtaAdapterControl

AtaPortInitializeEx