NT_Shutdown

This functionality is not available under Windows CE!

NT_Shutdown 1:

The Windows NT operating system can be shut down with the aid of the "NT_Shutdown" function block. The function largely corresponds to the Shut Down command on the Windows taskbar. A delay before execution of the Shut Down command can be defined via the DELAY parameter. Internally, an instance of the ADSWRTCTRL function block is called.

Requirements:

Operating systems (up to Windows 2000 and higher) perform with the aid of the "NT_Shutdown" function block  the "Shutdown with Power OFF" ( the computer switches its power OFF). This function can only be used on systems which are ACPI conform (Advanced Configuration and Power Interface). The ACPI functions should be activated in BIOS before the installation of the operating system.

NT_Shutdown 2:

The default TwinCAT settings are to perform shutdown with power OFF. You can disable the power OFF function in windows registry. Please add following entry (implemented in TwinCAT Version >= 2.7 Build >= 505):

"DisableACPIPowerOff"        REG_DWORD = 0x00000001 in Registry under: "HKEY_LOCAL_MACHINE\SOFTWARE\Beckhoff\TwinCAT\System"

VAR_INPUT

VAR_INPUT
    NETID       :T_AmsNetId;
    DELAY       :DWORD;
    START       :BOOL;
    TMOUT       :TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

NETID: It is possible here to provide the AmsNetId of the TwinCAT computer on which the operating system is to be shut down. If it is the local computer that is to be shut down, an empty string can be entered.

DELAY: The delay time, in seconds, before the Shut Down command is executed.

START: The function block is activated by a positive edge at this input.

TMOUT: States the length of the timeout that may not be exceeded by execution of the ADS command.

VAR_OUTPUT

VAR_OUTPUT
    BUSY         :BOOL;
    ERR          :BOOL;
    ERRID        :UDINT;
END_VAR

BUSY: When the function block is activated this output is set. It remains set until and acknowledgement is received.

ERR: If an ADS error should occur during the transfer of the command, then this output is set once the BUSY output is reset.

ERRID: Supplies the ADS error number when the ERR output is set.

Requirements

Development environment

Target system type

PLC libraries to include

TwinCAT v2.7.0

PC or CX (x86)

Standard.Lib; PLCSystem.Lib; TcPLCAds.Lib; PLCHelper.Lib; TcPlcUtilities.Lib

TwinCAT v2.8.0

PC or CX (x86)

TcUtilities.Lib

( Standard.Lib; TcBase.Lib; TcSystem.Lib are included automatically )

TwinCAT v2.10.0 Build >= 1301

CX (ARM)