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

[Применимо к KMDF и UMDF]

Функция обратного вызова событий драйвера EvtDeviceQueryStop определяет, можно ли остановить указанное устройство таким образом, чтобы диспетчер PnP может распространять системные аппаратные ресурсы.

Синтаксис

EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;

NTSTATUS EvtWdfDeviceQueryStop(
  [in] WDFDEVICE Device
)
{...}

Параметры

[in] Device

Дескриптор объекта устройства платформы.

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

Если драйвер определяет, что устройство может быть остановлено, функция обратного вызова EvtDeviceQueryStop должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(состояние) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS (состояние) равно FALSE. Не возвращайте STATUS_NOT_SUPPORTED.

Замечания

Чтобы зарегистрировать функцию обратного вызова EvtDeviceQueryStop, драйвер должен вызвать WdfDeviceInitSetPnpPowerEventCallbacks.

Если устройство и драйвер поддерживают отключенное питание, устройство может не находиться в рабочем состоянии, когда платформа вызывает функцию обратного вызова драйвера EvtDeviceQueryStop. Функция обратного вызова может вызывать WdfDeviceStopIdle, чтобы принудительно заставить устройство в рабочее состояние (D0), а затем функция обратного вызова может вызывать WdfDeviceResumeIdle перед возвратом.

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

Платформа не синхронизирует функцию обратного вызова EvtDeviceQueryStop с другими функциями обратного вызова PnP и управления питанием. Сведения о том, как платформа синхронизирует выполнение функций обратного вызова событий драйвера, см. в разделе Использование автоматической синхронизации.

Требования

См. также

EvtDeviceQueryRemove