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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[out, retval] pbSuccess

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

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

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

Замечания

Примечание. Перед вызовом этого метода необходимо вызвать метод IWDTFEnhancedDeviceTestSupportAction2::Enable для целевого устройства.

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

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

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	wdtfpnpaction.h

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