Функция IoUnregisterPlugPlayNotification (wdm.h)

  • Статья

Эта подпрограмма устарела в Windows 7 и более поздних версиях Windows. Дополнительные сведения см. в разделе Примечания ниже.

Процедура IoUnregisterPlugPlayNotification удаляет регистрацию процедуры обратного вызова драйвера для события PnP.

Синтаксис

NTSTATUS IoUnregisterPlugPlayNotification(
  [in] PVOID NotificationEntry
);

Параметры

[in] NotificationEntry

Указатель на непрозрачное значение, представляющее удаляемую регистрацию. Значение было возвращено предыдущим вызовом IoRegisterPlugPlayNotification.

Возвращаемое значение

IoUnregisterPlugPlayNotification всегда возвращает STATUS_SUCCESS, является ли NotificationEntry допустимым .

Комментарии

В Windows 7 и более поздних версиях Windows эта функция устарела и предоставляется только для поддержки существующих драйверов. Вместо этого используйте подпрограмму IoUnregisterPlugPlayNotificationEx .

Система не синхронизируется между выполнением процедуры уведомления и IoUnregisterPlugPlayNotification. Поэтому подпрограмму можно вызвать после возврата метода IoUnregisterPlugPlayNotification . При необходимости драйвер должен реализовать собственный механизм, чтобы игнорировать уведомления после вызова IoUnregisterPlugPlayNotification .

IoUnregisterPlugPlayNotification удаляет одну регистрацию уведомления PnP; то есть регистрация одной процедуры обратного вызова драйвера для одной категории событий PnP.

Драйверы должны сначала отменить регистрацию уведомления, а затем освободить любой связанный буфер контекста.

Драйвер не может быть выгружен до тех пор, пока он не удалит все свои регистрации уведомлений PnP, так как в объекте драйвера есть ссылка для каждой активной регистрации.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

См. также раздел

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx