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

  • Artículo

Intenta enviar un evento IRP_MN_STOP_DEVICE al dispositivo de destino y asignar nuevos recursos al dispositivo de destino.

Sintaxis

HRESULT EDTTryStopDeviceRequestNewResources(
  [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.
 
De forma similar al método EDTTryStopDevice , EDTTryStopDeviceRequestNewResources intenta desencadenar un reequilibrio de recursos PnP (por ejemplo, IRP_MN_STOP_DEVICE) en la pila de dispositivos de destino, con la adición de que el método intenta forzar el dispositivo en un nuevo conjunto de recursos de hardware.

No se garantiza la detención de IRP. Otros controladores de la pila pueden producir un error en el evento 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, puede ejecutar EDTTryStopDeviceRequestNewResources 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