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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[out, retval] pbSuccess

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

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

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

Замечания

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

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

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

Требования

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

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