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

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 hrESULT código de error.

Observaciones

Nota Se debe llamar al método IWDTFEnhancedDeviceTestSupportAction2::Enable para el dispositivo de destino antes de llamar a este método.

 

Al igual que el 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 al IRP de detención (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 aún desea probar cómo los controladores y las aplicaciones controlan el reequilibrio del recurso PnP, puede ejecutar en su lugar 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	Valor
de la plataforma de destino de	Escritorio
encabezado de	wdtfpnpaction.h