Функция 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) |