Метод IWDTFPNPAction2::EDTTryStopDeviceRequestNewResources (wdtfpnpaction.h)

Статья
02/29/2024

Пытается отправить событие IRP_MN_STOP_DEVICE на целевое устройство и назначить ему новые ресурсы.

Синтаксис

HRESULT EDTTryStopDeviceRequestNewResources(
  [out, retval] VARIANT_BOOL *pbSuccess
);

Параметры

[out, retval] pbSuccess

Значение true, если операция выполнена успешно; в противном случае — false.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Как и в случае с методом EDTTryStopDevice , EDTTryStopDeviceRequestNewResources пытается активировать перебалансировку ресурсов PnP (например, IRP_MN_STOP_DEVICE) в стеке целевых устройств, с добавлением того, что метод пытается принудительно применить устройство к новому набору аппаратных ресурсов.

Остановка IRP не гарантируется. Другие драйверы в стеке могут завершиться сбоем события IRP_MN_QUERY_STOP_DEVICE, которое предшествует остановке IRP (что приводит к IRP_MN_CANCEL_STOP_DEVICE). Кроме того, система может оптимизироваться, если обнаруживает, что целевое устройство не использует аппаратные ресурсы (например, USB-мышь) и отправляет вместо этого cancelStop IRP.

Если устройство не потребляет аппаратные ресурсы, но вы по-прежнему хотите проверить, как драйверы и приложения обрабатывают перераспределение ресурсов PnP, вместо этого можно запустить EDTTryStopDeviceRequestNewResources на родительском устройстве, бабушке и дедушке и т. д., который потребляет аппаратные ресурсы. Например, если устройство является USB-мышью, этот метод можно запустить на родительском USB-контроллере.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Professional
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Персональный компьютер
Верхняя часть	wdtfpnpaction.h

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

IWDTFPNPAction2

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