次の方法で共有


IoUnregisterPlugPlayNotification 関数 (wdm.h)

このルーチンは、Windows 7 以降のバージョンの Windows では廃止されています。 詳細については、後述の「解説」セクションを参照してください。

IoUnregisterPlugPlayNotification ルーチンは、PnP イベントのドライバーのコールバック ルーチンの登録を削除します。

構文

NTSTATUS IoUnregisterPlugPlayNotification(
  [in] PVOID NotificationEntry
);

パラメーター

[in] NotificationEntry

削除する登録を表す不透明な値へのポインター。 値は、IoRegisterPlugPlayNotification 以前の呼び出しによって返されました。

戻り値

IoUnregisterPlugPlayNotification NotificationEntry が有効な場合、常にSTATUS_SUCCESSを返します。

備考

Windows 7 以降のバージョンの Windows では、この関数は廃止され、既存のドライバーをサポートするためにのみ提供されています。 代わりに、IoUnregisterPlugPlayNotificationEx ルーチンを使用してください。

システムは、通知ルーチンの実行と IoUnregisterPlugPlayNotification の間で同期しません。 そのため、IoUnregisterPlugPlayNotification メソッドが返された後にルーチンを呼び出すことができます。 必要に応じて、ドライバーは、IoUnregisterPlugPlayNotification が呼び出された後 通知を無視する独自のメカニズムを実装する必要があります。

IoUnregisterPlugPlayNotification 、1 つの PnP 通知登録が削除されます。つまり、1 つの PnP イベント カテゴリに対する 1 つのドライバー コールバック ルーチンの登録です。

ドライバーは、最初に通知の登録を解除してから、関連するコンテキスト バッファーを解放する必要があります。

アクティブな登録ごとにドライバー オブジェクトに参照があるため、PnP 通知登録をすべて削除するまで、ドライバーをアンロードすることはできません。

必要条件

要件 価値
ターゲット プラットフォーム 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 する HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

関連項目

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx