IoUnregisterPlugPlayNotificationEx 函式 (wdm.h)

IoUnregisterPlugPlayNotificationEx常式會取消驅動程式回呼常式的註冊,以通知 隨插即用 (PnP) 事件。

語法

NTSTATUS IoUnregisterPlugPlayNotificationEx(
  [in] PVOID NotificationEntry
);

參數

[in] NotificationEntry

不透明值的指標,表示要取消的註冊。 呼叫端先前藉由呼叫 IoRegisterPlugPlayNotification 常式來取得此值。

傳回值

如果NotificationEntry參數有效,IoUnregisterPlugPlayNotificationEx會傳回STATUS_SUCCESS。

備註

核心模式驅動程式會呼叫此常式,以移除註冊以接收 PnP 通知。 也就是說, IoUnregisterPlugPlayNotificationEx 呼叫會取消一個 PnP 事件類別目錄的驅動程式回呼常式註冊。 驅動程式先前藉由呼叫 IoRegisterPlugPlayNotification 常式來取得此註冊。

IoUnregisterPlugPlayNotificationEx呼叫傳回之後,就會取消指定的註冊,而且不會再發生任何回呼。

IoUnregisterPlugPlayNotification常式類似于IoUnregisterPlugPlayNotificationEx,不同之處在于它無法保證IoUnregisterPlugPlayNotification呼叫傳回之後不會發生進一步的回呼。

通常,驅動程式會從通知回呼常式呼叫 IoUnregisterPlugPlayNotificationEx 。 在大部分情況下,驅動程式可以透過這種方式安全地刪除通知回呼常式的註冊。 不過,如果下列兩者都成立,通知回呼常式呼叫 IoUnregisterPlugPlayNotificationEx 來取消註冊本身是不安全的:

  • 驅動程式會在提供給註冊通知回呼常式之IoRegisterPlugPlayNotification呼叫的EventCategoryFlags參數值中設定PNPNOTIFY_DEVICE_INTERFACE_INCLUDE_EXISTING_INTERFACES旗標。
  • 註冊通知回呼常式的 IoRegisterPlugPlayNotification 呼叫尚未傳回。
回呼常式不得呼叫任何可能會封鎖回呼常式執行所線上程的常式。 例如,如果設計不佳的回呼常式會在工作專案佇列中放置呼叫 IoUnregisterPlugPlayNotificationEx 的工作專案,然後等候背景工作執行緒完成工作專案,則會導致作業系統死結。

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

除非驅動程式移除其所有 PnP 通知註冊,否則無法卸載驅動程式,因為每個作用中註冊都會保留代表驅動程式載入映射的 驅動程式物件的 計數參考。

如需詳細資訊,請參閱 使用 PnP 通知

規格需求

   
最低支援的用戶端 從 Windows 7 開始提供。
目標平臺 環球
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport) PowerIrpDDis (wdm)

另請參閱

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification