//----------------------------------------------------------------------------
//
// Copyright © 2009-2010, Intel Corporation. All rights reserved.
//
// File:        IUserConsentFlow.cs
//
//----------------------------------------------------------------------------

using System;
using System.Collections.Generic;
using System.Text;

namespace UCT
{
    public interface IUserConsentFlow
    {
        #region - User Consent Flow -

        /// <summary>
        /// Indicaes if user consent is required for any operation
        /// </summary>
        /// <returns></returns>
        bool CheckIfConsentIsRequired();

        /// <summary>
        /// Indicate if user consent was already obtain
        /// </summary>
        /// <returns></returns>
        bool CheckIfConsentAlreadyObtain();

        /// <summary>
        /// Check if system power state is in Sx - if so reboot the system
        /// </summary>
        /// <returns></returns>
        void PerformSxFlow();

        /// <summary>
        /// Start the user consent flow
        /// </summary>
        /// <returns></returns>
        bool StartUserConsentProcess();

        /// <summary>
        /// Detecting if sprite is supported
        /// </summary>
        void DetectingIfSpriteIsSupported();

        /// <summary>
        /// If system interface is wireless perform wireless flow.
        /// </summary>
        void ExecuteWirelessFlow();

        /// <summary>
        /// If sprite is not supported and interface is wired - perform the regular non sprite flow
        /// </summary>
        void ExecuteNonSpriteFlow();

        /// <summary>
        /// Execute full user consent flow
        /// </summary>
        void RunFullFlow();

        #endregion

        #region  - Help Methods - 

        bool PerformGracefulShutdown();

        bool PerformAMTShutDown(PowerState pState);

        #endregion
    }
}