Поделиться через


функция обратного вызова EVT_WDF_DEVICE_SHUTDOWN_NOTIFICATION (wdfcontrol.h)

[Относится только к KMDF]

Функция обратного вызова события EvtDeviceShutdownNotification драйвера уведомляет драйвер о том, что система вот-вот потеряет свою мощность.

Синтаксис

EVT_WDF_DEVICE_SHUTDOWN_NOTIFICATION EvtWdfDeviceShutdownNotification;

void EvtWdfDeviceShutdownNotification(
  [in] WDFDEVICE Device
)
{...}

Параметры

[in] Device

Дескриптор объекта устройства платформы, который драйвер инициализировал, вызвав WdfControlDeviceInitAllocate.

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

None

Remarks

Чтобы зарегистрировать функцию обратного вызова события EvtDeviceShutdownNotification , драйвер должен вызвать WdfControlDeviceInitSetShutdownNotification. Регистрировать эту функцию обратного вызова могут только драйверы, создающие объекты управляющих устройств.

Платформа вызывает функцию обратного вызова события EvtDeviceShutdownNotification драйвера, если пользователь вот-вот выключит компьютер или если компьютер внезапно теряет питание, и для безопасного отключения компьютера доступен аварийный источник питания, например источник бесперебойного питания (ИБП).

Дополнительные сведения об объектах управления устройствами и функции обратного вызова EvtDeviceShutdownNotification см. в разделе Использование объектов управления устройствами.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfcontrol.h (включая Wdf.h)
IRQL PASSIVE_LEVEL

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

WdfControlDeviceInitAllocate

WdfControlDeviceInitSetShutdownNotification