Share via


DriverEntry 傳回值

DriverEntry常式會傳回NTSTATUS 值,STATUS_SUCCESS或適當的錯誤狀態。

DriverEntry常式應該延後對IoRegisterDriverReinitialization的任何呼叫,直到傳回STATUS_SUCCESS之前為止。 除非它會傳回STATUS_SUCCESS,否則它不得進行此呼叫。

如果 DriverEntry 常式傳回不是成功或參考值的 NTSTATUS 值,例如STATUS_SUCCESS,則不會載入 該 DriverEntry 常式的驅動程式。

將初始化失敗的 DriverEntry 常式必須釋放它已設定的任何系統物件、系統資源和登錄資源,才能傳回控制權。 如果驅動程式支援這些要求,則應該將驅動程式的分派進入點重設為 驅動程式物件的IRP_MJ_FLUSH_BUFFERS ,並將 IRP_MJ_SHUTDOWN 重設為 Null

如果驅動程式初始化失敗, DriverEntry 常式也應該在傳回控制項之前記錄錯誤。 請參閱 記錄錯誤

請注意,如果驅動程式的DriverEntry常式傳回失敗狀態,則不會呼叫驅動程式的Unload常式。