Subsystem.StopForce Method

Stops the Subsystem, even if RTSS processes or Windows processes linked to RTX64 are still running. If the Subsystem fails to stop properly, this method throws an exception of type RTX64Win32Exception, and instance property State returns STOP_ERROR.

Namespace:  IntervalZero.RTX64.Control
Assembly:  IntervalZero.RTX64 (in IntervalZero.RTX64.dll) Version: 4.0.0.0 (File version: 4.5.0)

Syntax
public void StopForce()

Parameters

This method has no parameters.

Remarks

IMPORTANT! If this method throws an exception containing the error RT_ERROR_TIMEOUT_STOPPING_SUBSYSTEM, the Subsystem will likely be left in an error state as parts of the Subsystem shut down. This is most likely to occur if there are real-time applications running that have shutdown handlers attached, and whose shutdown handler threads may take more than 60 seconds to finish executing. While in this state, additional calls to this function can be made, but they will continue to fail with the same error if the shutdown handler threads are still running. If this condition persists longer than expected, the only recovery option is a full system restart.

Implements

IControlSubsystem.StopForce

Exceptions

ExceptionCondition

RTX64Win32Exception

Throws an instance of RTX64Win32Exception if a failure occurs when attempting to stop the Subsystem.

 

See Also