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 欄位中指定的函式,其具有 ChannelExtensionSize 大小的 ChannelExtension。 當 AtaAdapterControl 處理 IdeStart 動作時,AtaAdapterControl 所傳回的每個 ControllerConfiguration 結構中指定的 NumberOfChannels 都會呼叫函式一次。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | mcd.h (包括 Ntddk.h、Mcd.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |