共用方式為


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 呼叫 NdisMRegisterMiniportNdisIMRegisterLayeredMiniport 之後,從其 DriverEntry 函式呼叫 NdisMRegisterUnloadHandlerNdisMRegisterUnloadHandler 會註冊驅動程式的卸除處理程式。

卸除處理程式的功能是驅動程式特定的。 例如,中繼驅動程式應該註冊卸除處理程式,以呼叫 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

另請參閱