NdisMDeregisterDevice 函式 (ndis.h)

注意 NDIS 5. x 已被取代，且由 NDIS 6 取代。 x。 如需新的 NDIS 驅動程式開發，請參閱 從 Windows Vista 開始的網路驅動程式。 如需移植 NDIS 5 的相關信息。 x 驅動程式至 NDIS 6。 x，請參閱 將 NDIS 5.x 驅動程式移植到 NDIS 6.0。

NdisMDeregisterDevice 函式會從系統移除使用 NdisMRegisterDevice 建立的裝置物件。 NdisMDeregisterDevice 也會移除與此裝置對象相關聯的符號連結。

語法

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

參數

[in] NdisDeviceHandle

指定要取消註冊之裝置物件的 NdisMRegisterDevice 所傳回的句柄。

傳回值

如果刪除裝置物件及其相關聯的符號連結物件，NdisMDeregisterDevice 會傳回NDIS_STATUS_SUCCESS。

備註

驅動程式會從其 Halt 或 Unload 函式呼叫 NdisMDeregisterDevice，以取消註冊先前使用 NdisMRegisterDevice 建立的獨立裝置物件。 驅動程式必須在卸除時呼叫 NdisMDeregisterDevice ，或其 DriverEntry 例程遇到嚴重初始化錯誤時，例如無法取得系統資源。

呼叫 NdisMRegisterDevice 時，無法刪除裝置物件上任何未完成的使用者模式開啟作業。 如果有，就會發生系統錯誤。

• 目標平臺： 通用
• 版本：Windows Vista 中不支援 NDIS 6.0 驅動程式。 Windows Vista 和 Windows XP 中支援 NDIS 5.1 驅動程式。

規格需求

需求	值
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL

另請參閱

• MiniportHalt
• NdisMRegisterDevice
• NdisMRegisterUnloadHandler