Método IWDTFPNPAction2::EDTTryStopDeviceFailRestart (wdtfpnpaction.h)

  • Artículo

Intenta enviar un evento de IRP_MN_STOP_DEVICE al dispositivo de destino y, a continuación, produce un error en el reinicio posterior del dispositivo.

Sintaxis

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

Parámetros

[out, retval] pbSuccess

True si la operación se realiza correctamente; de lo contrario, false.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Nota Se debe llamar al método IWDTFEnhancedDeviceTestSupportAction2::Enable para el dispositivo de destino antes de llamar a este método.
 
EDTTryStopDeviceFailRestart intenta desencadenar un reequilibrio de recursos PnP (una secuencia query Stop, Stop, Start IRP) en la que se produce un error en el evento IRP_MN_START_DEVICE que sigue a una consulta de detención y detención correctas. El IRP con errores inicia, a su vez, hace que el sistema quite el dispositivo (IRP_MN_SURPRISE_REMOVAL).

No se garantiza la detención de IRP. Otros controladores de la pila pueden producir un error en un evento de IRP_MN_QUERY_STOP_DEVICE que precede a Stop IRP (lo que da lugar a IRP_MN_CANCEL_STOP_DEVICE). Además, el sistema puede optimizar si detecta que el dispositivo de destino no usa recursos de hardware (por ejemplo, un mouse USB) y envía un IRP CancelStop en su lugar.

Si el dispositivo no consume recursos de hardware, pero desea intentar probar cómo los controladores y las aplicaciones controlan el reequilibrio de recursos PnP con un inicio erróneo, en su lugar puede ejecutar el método EDTTryStopDeviceFailRestart en un dispositivo primario, abuelo, etc., que consume recursos de hardware. Por ejemplo, si el dispositivo es un mouse USB, puede ejecutar este método en el controlador USB primario en su lugar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Professional
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Escritorio
Encabezado wdtfpnpaction.h

Consulte también

IWDTFPNPAction2