NdisMRegisterUnloadHandler 函式 (ndis.h)
注意 NDIS 5. x 已被取代,且由 NDIS 6 取代。 x。 如需新的 NDIS 驅動程式開發,請參閱 從 Windows Vista 開始的網路驅動程式。 如需移植 NDIS 5 的相關信息。 x 驅動程式至 NDIS 6。 x,請參閱 將 NDIS 5.x 驅動程式移植到 NDIS 6.0。
NdisMRegisterUnloadHandler 函式會註冊驅動程式的卸載處理程式。
語法
void NdisMRegisterUnloadHandler(
[in] NDIS_HANDLE NdisWrapperHandle,
[in] PDRIVER_UNLOAD UnloadHandler
);
參數
[in] NdisWrapperHandle
指定 NdisMInitializeWrapper 所傳回的句柄。
[in] UnloadHandler
指定驅動程式卸除例程的進入點。 卸除例程的宣告如下:
VOID
(*PDRIVER_UNLOAD) (
IN struct _DRIVER_OBJECT *DriverObject
);
傳回值
無
備註
驅動程式會在 DriverEntry 呼叫 NdisMRegisterMiniport 或 NdisIMRegisterLayeredMiniport 之後,從其 DriverEntry 函式呼叫 NdisMRegisterUnloadHandler。 NdisMRegisterUnloadHandler 會註冊驅動程式的卸除處理程式。
卸除處理程式的功能是驅動程式特定的。 例如,中繼驅動程式應該註冊卸除處理程式,以呼叫 NdisDeregisterProtocol 來取消註冊中繼驅動程式的通訊協定部分。 卸除處理程式也應該執行任何必要的清除作業,例如解除分配驅動程式的通訊協定部分所使用的資源。
迷你埠驅動程式,例如負載平衡迷你埠驅動程式,監視多個迷你埠驅動程序實例應該註冊卸除處理程式,以清除狀態資訊,並在停止監視的迷你埠驅動程序實例之後解除分配資源。 請注意,卸除處理程式與 MiniportHalt 函式不同:卸除處理程式具有更全域的範圍,而 MiniportHalt 函式的範圍則受限於特定的迷你埠驅動程序實例。
- 目標平臺: 通用
- 版本:Windows Vista 中不支援 NDIS 6.0 驅動程式。 請改用 NdisMRegisterMiniportDriver。 Windows Vista 和 Windows XP 中支援 NDIS 5.1 驅動程式。
規格需求
需求 | 值 |
---|---|
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |