IoUnregisterPlugPlayNotification 函式 (wdm.h)

  • 發行項

此例程在 Windows 7 和更新版本的 Windows 中已過時。 如需詳細資訊，請參閱下面的＜備註＞一節。

IoUnregisterPlugPlayNotification 例程會移除 PnP 事件的驅動程式回呼例程註冊。

語法

NTSTATUS IoUnregisterPlugPlayNotification(
  [in] PVOID NotificationEntry
);

參數

[in] NotificationEntry

不透明值的指標，表示要移除的註冊。 值是由先前呼叫 IoRegisterPlugPlayNotification 所傳回。

傳回值

如果 NotificationEntry 有效，IoUnregisterPlugPlayNotification 一律會傳回STATUS_SUCCESS。

備註

在 Windows 7 和更新版本的 Windows 中，此函式已過時，僅提供以支援現有的驅動程式。 請改用 IoUnregisterPlugPlayNotificationEx 例程。

系統不會同步處理通知例程的執行與 IoUnregisterPlugPlayNotification。 因此，可以在 傳回 IoUnregisterPlugPlayNotification 方法之後呼叫例程。 如有必要，驅動程式應該實作自己的機制，以忽略 呼叫IoUnregisterPlugPlayNotification 之後的任何通知。

IoUnregisterPlugPlayNotification 會移除一個 PnP 通知註冊;也就是說，一個 PnP 事件類別目錄的一個驅動程式回呼例程註冊。

驅動程式應該先取消註冊通知，然後釋放任何相關的內容緩衝區。

除非驅動程式移除其所有 PnP 通知註冊，否則無法卸除驅動程式，因為每個使用中註冊的驅動程式物件都有參考。

規格需求

需求 值
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)

另請參閱

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx