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 は、1 つの PnP 通知登録を削除します。つまり、1 つの PnP イベント カテゴリに対する 1 つのドライバー コールバック ルーチンの登録です。
ドライバーは、最初に通知の登録を解除してから、関連するコンテキスト バッファーを解放する必要があります。
アクティブな登録ごとにドライバー オブジェクトに参照があるため、PnP 通知登録をすべて削除するまで、ドライバーをアンロードすることはできません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |