Функция DriverEntry (mcd.h)

Подпрограмма драйвера miniport 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 (включая Ntddk.h, Mcd.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe

См. также раздел

AtaAdapterControl

AtaPortInitializeEx