Main/include/ConsoleImpl.h

	ConsoleImpl.h revision 96660292fc1310c7afc8ef68c10c990858693638
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync/** @file
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *
5b281ba489ca18f0380d7efc7a5108b606cce449vboxsync * VBox Console COM Class definition
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync/*
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync * Copyright (C) 2006-2007 innotek GmbH
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync * available from http://www.virtualbox.org. This file is free software;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync * you can redistribute it and/or modify it under the terms of the GNU
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * General Public License as published by the Free Software Foundation,
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * in version 2 as it comes in the "COPYING" file of the VirtualBox OSE
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * distribution. VirtualBox OSE is distributed in the hope that it will
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * be useful, but WITHOUT ANY WARRANTY of any kind.
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync *
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * If you received this file as part of a commercial VirtualBox
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * distribution, then only the terms of your commercial VirtualBox
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * license agreement apply instead of the previous paragraph.
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync */
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync#ifndef ____H_CONSOLEIMPL
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync#define ____H_CONSOLEIMPL
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync#include "VirtualBoxBase.h"
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync#include "ProgressImpl.h"
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsyncclass Guest;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass Keyboard;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass Mouse;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass Display;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass MachineDebugger;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass OUSBDevice;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass RemoteUSBDevice;
5eabf773597082761832bc0a32b3660e8771f9f1vboxsyncclass SharedFolder;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass RemoteDisplayInfo;
5eabf773597082761832bc0a32b3660e8771f9f1vboxsyncclass AudioSniffer;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass ConsoleVRDPServer;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass VMMDev;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#include <VBox/vrdpapi.h>
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#include <VBox/pdmdrv.h>
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncstruct VUSBIRHCONFIG;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsynctypedef struct VUSBIRHCONFIG *PVUSBIRHCONFIG;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#include <list>
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync// defines
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync///////////////////////////////////////////////////////////////////////////////
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync/**
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  Checks the availability of the underlying VM device driver corresponding
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  to the COM interface (IKeyboard, IMouse, IDisplay, etc.). When the driver is
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  not available (NULL), sets error info and returns returns E_ACCESSDENIED.
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  The translatable error message is defined in null context.
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  Intended to used only within Console children (i,e. Keyboard, Mouse,
5eabf773597082761832bc0a32b3660e8771f9f1vboxsync *  Display, etc.).
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  @param drv  driver pointer to check (compare it with NULL)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#define CHECK_CONSOLE_DRV(drv) \
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    do { \
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync        if (!(drv)) \
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync            return setError (E_ACCESSDENIED, tr ("The console is not powered up")); \
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    } while (0)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync/** @def VBOX_WITH_UNIXY_TAP_NETWORKING
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  Unixy style TAP networking. This is defined in the Makefile since it's also
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync *  used by NetworkAdapterImpl.h/cpp.
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#ifdef __DOXYGEN__
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync# define VBOX_WITH_UNIXY_TAP_NETWORKING
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#endif
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync// Console
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync///////////////////////////////////////////////////////////////////////////////
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync/** IConsole implementation class */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncclass ATL_NO_VTABLE Console :
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    public VirtualBoxBaseWithChildrenNEXT,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    public VirtualBoxSupportErrorInfoImpl <Console, IConsole>,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    public VirtualBoxSupportTranslation <Console>,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    public IConsole
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync{
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    Q_OBJECT
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncpublic:
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    DECLARE_NOT_AGGREGATABLE(Console)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    DECLARE_PROTECT_FINAL_CONSTRUCT()
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    BEGIN_COM_MAP(Console)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync        COM_INTERFACE_ENTRY(ISupportErrorInfo)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync        COM_INTERFACE_ENTRY(IConsole)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    END_COM_MAP()
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    NS_DECL_ISUPPORTS
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    Console();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    ~Console();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT FinalConstruct();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void FinalRelease();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // public initializers/uninitializers for internal purposes only
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT init (IMachine *aMachine, IInternalMachineControl *aControl);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void uninit();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // IConsole properties
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(Machine)) (IMachine **aMachine);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(State)) (MachineState_T *aMachineState);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(Guest)) (IGuest **aGuest);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(Keyboard)) (IKeyboard **aKeyboard);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(Mouse)) (IMouse **aMouse);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(Display)) (IDisplay **aDisplay);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(Debugger)) (IMachineDebugger **aDebugger);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(USBDevices)) (IUSBDeviceCollection **aUSBDevices);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(RemoteUSBDevices)) (IHostUSBDeviceCollection **aRemoteUSBDevices);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(RemoteDisplayInfo)) (IRemoteDisplayInfo **aRemoteDisplayInfo);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(COMGETTER(SharedFolders)) (ISharedFolderCollection **aSharedFolders);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // IConsole methods
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(PowerUp) (IProgress **aProgress);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(PowerDown)();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(Reset)();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(Pause)();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(Resume)();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(PowerButton)();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(SaveState) (IProgress **aProgress);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(DiscardSavedState)();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(GetDeviceActivity) (DeviceType_T aDeviceType,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync                                 DeviceActivity_T *aDeviceActivity);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(AttachUSBDevice) (INPTR GUIDPARAM aId);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(DetachUSBDevice) (INPTR GUIDPARAM aId, IUSBDevice **aDevice);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(CreateSharedFolder) (INPTR BSTR aName, INPTR BSTR aHostPath);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(RemoveSharedFolder) (INPTR BSTR aName);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(TakeSnapshot) (INPTR BSTR aName, INPTR BSTR aDescription,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync                             IProgress **aProgress);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(DiscardSnapshot) (INPTR GUIDPARAM aId, IProgress **aProgress);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(DiscardCurrentState) (IProgress **aProgress);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(DiscardCurrentSnapshotAndState) (IProgress **aProgress);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(RegisterCallback) (IConsoleCallback *aCallback);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    STDMETHOD(UnregisterCallback)(IConsoleCallback *aCallback);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // public methods for internal purposes only
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    /*
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync     *  Note: the following methods do not increase refcount. intended to be
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync     *  called only by the VM execution thread.
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync     */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    Guest *getGuest() { return mGuest; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    Keyboard *getKeyboard() { return mKeyboard; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    Mouse *getMouse() { return mMouse; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    Display *getDisplay() { return mDisplay; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    MachineDebugger *getMachineDebugger() { return mDebugger; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    const ComPtr <IMachine> &machine() { return mMachine; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    /** Method is called only from ConsoleVRDPServer */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    IVRDPServer *getVRDPServer() { return mVRDPServer; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    ConsoleVRDPServer *consoleVRDPServer() { return mConsoleVRDPServer; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT updateMachineState (MachineState_T aMachineState);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // events from IInternalSessionControl
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onDVDDriveChange();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onFloppyDriveChange();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onNetworkAdapterChange(INetworkAdapter *networkAdapter);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onSerialPortChange(ISerialPort *serialPort);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onParallelPortChange(IParallelPort *parallelPort);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onVRDPServerChange();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onUSBControllerChange();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onUSBDeviceAttach (IUSBDevice *aDevice, IVirtualBoxErrorInfo *aError);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onUSBDeviceDetach (INPTR GUIDPARAM aId, IVirtualBoxErrorInfo *aError);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    VMMDev *getVMMDev() { return mVMMDev; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    AudioSniffer *getAudioSniffer () { return mAudioSniffer; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#ifdef VRDP_NO_COM
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    int VRDPClientLogon (uint32_t u32ClientId, const char *pszUser, const char *pszPassword, const char *pszDomain);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void VRDPClientConnect (uint32_t u32ClientId);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void VRDPClientDisconnect (uint32_t u32ClientId, uint32_t fu32Intercepted);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void VRDPInterceptAudio (uint32_t u32ClientId);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void VRDPInterceptUSB (uint32_t u32ClientId);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void VRDPInterceptClipboard (uint32_t u32ClientId);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#else
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    static VRDPSERVERCALLBACK *getVrdpServerCallback () { return &sVrdpServerCallback; };
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync#endif /* VRDP_NO_COM */
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void processRemoteUSBDevices (uint32_t u32ClientId, VRDPUSBDEVICEDESC *pDevList, uint32_t cbDevList);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // callback callers
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onMousePointerShapeChange(bool fVisible, bool fAlpha,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync                                   uint32_t xHot, uint32_t yHot,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync                                   uint32_t width, uint32_t height,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync                                   void *pShape);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onMouseCapabilityChange (BOOL supportsAbsolute, BOOL needsHostCursor);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onStateChange (MachineState_T aMachineState);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onAdditionsStateChange();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onAdditionsOutdated();
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onKeyboardLedsChange (bool fNumLock, bool fCapsLock, bool fScrollLock);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onUSBDeviceStateChange (IUSBDevice *aDevice, bool aAttached,
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync                                 IVirtualBoxErrorInfo *aError);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void onRuntimeError (BOOL aFatal, INPTR BSTR aErrorID, INPTR BSTR aMessage);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    HRESULT onShowWindow (BOOL aCheck, BOOL *aCanShow, ULONG64 *aWinId);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    static const PDMDRVREG DrvStatusReg;
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    void reportAuthLibraryError (const char *filename, int rc)
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    {
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync        setError (E_FAIL, tr("Could not load the external authentication library '%s' (%Vrc)"), filename, rc);
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    // for VirtualBoxSupportErrorInfoImpl
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    static const wchar_t *getComponentName() { return L"Console"; }
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsyncprivate:
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync    /**
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync     *  Base template for AutoVMCaller and SaveVMPtr. Template arguments
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync     *  have the same meaning as arguments of Console::addVMCaller().
ababd7e83ee3d23c5191a0d3802f10764df69e36vboxsync     */
    template <bool taQuiet = false, bool taAllowNullVM = false>
    class AutoVMCallerBase
    {
    public:
        AutoVMCallerBase (Console *aThat) : mThat (aThat), mRC (S_OK)
        {
            Assert (aThat);
            mRC = aThat->addVMCaller (taQuiet, taAllowNullVM);
        }
        ~AutoVMCallerBase()
        {
            if (SUCCEEDED (mRC))
                mThat->releaseVMCaller();
        }
        /** Decreases the number of callers before the instance is destroyed. */
        void release()
        {
            AssertReturnVoid (SUCCEEDED (mRC));
            mThat->releaseVMCaller();
            mRC = E_FAIL;
        }
        /** Restores the number of callers after by #release(). #rc() must be
         *  rechecked to ensure the operation succeeded. */
        void add()
        {
            AssertReturnVoid (!SUCCEEDED (mRC));
            mRC = mThat->addVMCaller (taQuiet, taAllowNullVM);
        }
        /** Returns the result of Console::addVMCaller() */
        HRESULT rc() const { return mRC; }
        /** Shortcut to SUCCEEDED (rc()) */
        bool isOk() const { return SUCCEEDED (mRC); }
    protected:
        Console *mThat;
        HRESULT mRC;
    private:
        DECLARE_CLS_COPY_CTOR_ASSIGN_NOOP (AutoVMCallerBase)
        DECLARE_CLS_NEW_DELETE_NOOP (AutoVMCallerBase)
    };

    /**
     *  Helper class that protects sections of code using the mpVM pointer by
     *  automatically calling addVMCaller() on construction and
     *  releaseVMCaller() on destruction. Intended for Console methods dealing
     *  with mpVM. The usage pattern is:
     *  <code>
     *      AutoVMCaller autoVMCaller (this);
     *      CheckComRCReturnRC (autoVMCaller.rc());
     *      ...
     *      VMR3ReqCall (mpVM, ...
     *  </code>
     *
     *  @sa SafeVMPtr, SafeVMPtrQuiet
     */
    typedef AutoVMCallerBase <false, false> AutoVMCaller;

    /**
     *  Same as AutoVMCaller but doesn't set extended error info on failure.
     */
    typedef AutoVMCallerBase <true, false> AutoVMCallerQuiet;

    /**
     *  Base template for SaveVMPtr and SaveVMPtrQuiet.
     */
    template <bool taQuiet = false>
    class SafeVMPtrBase : public AutoVMCallerBase <taQuiet, true>
    {
        typedef AutoVMCallerBase <taQuiet, true> Base;
    public:
        SafeVMPtrBase (Console *aThat) : Base (aThat), mpVM (NULL)
        {
            if (SUCCEEDED (Base::mRC))
                mpVM = aThat->mpVM;
        }
        /** Smart SaveVMPtr to PVM cast operator */
        operator PVM() const { return mpVM; }
        /** Direct PVM access for printf()-like functions */
        PVM raw() const { return mpVM; }
    private:
        PVM mpVM;
        DECLARE_CLS_COPY_CTOR_ASSIGN_NOOP (SafeVMPtrBase)
        DECLARE_CLS_NEW_DELETE_NOOP (SafeVMPtrBase)
    };

public:

    /**
     *  Helper class that safely manages the Console::mpVM pointer
     *  by calling addVMCaller() on construction and releaseVMCaller() on
     *  destruction. Intended for Console children. The usage pattern is:
     *  <code>
     *      Console::SaveVMPtr pVM (mParent);
     *      CheckComRCReturnRC (pVM.rc());
     *      ...
     *      VMR3ReqCall (pVM, ...
     *      ...
     *      printf ("%p\n", pVM.raw());
     *  </code>
     *
     *  @sa SafeVMPtrQuiet, AutoVMCaller
     */
    typedef SafeVMPtrBase <false> SafeVMPtr;

    /**
     *  A deviation of SaveVMPtr that doesn't set the error info on failure.
     *  Intenede for pieces of code that don't need to return the VM access
     *  failure to the caller. The usage pattern is:
     *  <code>
     *      Console::SaveVMPtrQuiet pVM (mParent);
     *      if (pVM.rc())
     *          VMR3ReqCall (pVM, ...
     *      return S_OK;
     *  </code>
     *
     *  @sa SafeVMPtr, AutoVMCaller
     */
    typedef SafeVMPtrBase <true> SafeVMPtrQuiet;

private:

    typedef std::list <ComObjPtr <OUSBDevice> > USBDeviceList;
    typedef std::list <ComObjPtr <RemoteUSBDevice> > RemoteUSBDeviceList;
    typedef std::list <ComObjPtr <SharedFolder> > SharedFolderList;

    HRESULT addVMCaller (bool aQuiet = false, bool aAllowNullVM = false);
    void releaseVMCaller();

    HRESULT powerDown();

    HRESULT callTapSetupApplication(bool isStatic, RTFILE tapFD, Bstr &tapDevice,
                                    Bstr &tapSetupApplication);
    HRESULT attachToHostInterface(INetworkAdapter *networkAdapter);
    HRESULT detachFromHostInterface(INetworkAdapter *networkAdapter);
    HRESULT powerDownHostInterfaces();

    HRESULT setMachineState (MachineState_T aMachineState, bool aUpdateServer = true);
    HRESULT setMachineStateLocally (MachineState_T aMachineState)
    {
        return setMachineState (aMachineState, false /* aUpdateServer */);
    }

    HRESULT findSharedFolder (const BSTR aName,
                              ComObjPtr <SharedFolder> &aSharedFolder,
                              bool aSetError = false);

    static DECLCALLBACK(int) configConstructor(PVM pVM, void *pvConsole);
    static DECLCALLBACK(void) vmstateChangeCallback(PVM aVM, VMSTATE aState,
                                                    VMSTATE aOldState, void *aUser);
    HRESULT doDriveChange (const char *pszDevice, unsigned uInstance,
                           unsigned uLun, DriveState_T eState,
                           DriveState_T *peState, const char *pszPath,
                           bool fPassthrough);
    static DECLCALLBACK(int) changeDrive (Console *pThis, const char *pszDevice,
                                          unsigned uInstance, unsigned uLun,
                                          DriveState_T eState, DriveState_T *peState,
                                          const char *pszPath, bool fPassthrough);

#if 1
    HRESULT attachUSBDevice (IUSBDevice *aHostDevice, PVUSBIRHCONFIG aConfig);
    HRESULT detachUSBDevice (USBDeviceList::iterator &aIt);

    static DECLCALLBACK(int)
    usbAttachCallback (Console *that, IUSBDevice *aHostDevice,
                       PVUSBIRHCONFIG aConfig, PCRTUUID aUuid, bool aRemote,
                       const char *aAddress, void *aRemoteBackend);
#else /* PDMUsb coding. */
    HRESULT attachUSBDevice (IUSBDevice *aHostDevice);
    HRESULT detachUSBDevice (USBDeviceList::iterator &aIt);

    static DECLCALLBACK(int)
    usbAttachCallback (Console *that, IUSBDevice *aHostDevice, PCRTUUID aUuid,
                       bool aRemote, const char *aAddress, void *aRemoteBackend);
#endif /* PDMUsb coding. */
    static DECLCALLBACK(int)
    usbDetachCallback (Console *that, USBDeviceList::iterator *aIt,
                       PVUSBIRHCONFIG aConfig, PCRTUUID aUuid);

    static DECLCALLBACK (int)
    stateProgressCallback (PVM pVM, unsigned uPercent, void *pvUser);

    static DECLCALLBACK(void)
    setVMErrorCallback (PVM pVM, void *pvUser, int rc, RT_SRC_POS_DECL,
                        const char *pszFormat, va_list args);

    static DECLCALLBACK(void)
    setVMRuntimeErrorCallback (PVM pVM, void *pvUser, bool fFatal,
                               const char *pszErrorID,
                               const char *pszFormat, va_list args);

    HRESULT                     captureUSBDevices (PVM pVM);
    void                        detachAllUSBDevices (bool aDone);

    static DECLCALLBACK (int)   powerUpThread (RTTHREAD Thread, void *pvUser);
    static DECLCALLBACK (int)   saveStateThread (RTTHREAD Thread, void *pvUser);
    static DECLCALLBACK (int)   powerDownThread (RTTHREAD Thread, void *pvUser);

    static DECLCALLBACK(void *) drvStatus_QueryInterface(PPDMIBASE pInterface, PDMINTERFACE enmInterface);
    static DECLCALLBACK(void)   drvStatus_UnitChanged(PPDMILEDCONNECTORS pInterface, unsigned iLUN);
    static DECLCALLBACK(void)   drvStatus_Destruct(PPDMDRVINS pDrvIns);
    static DECLCALLBACK(int)    drvStatus_Construct(PPDMDRVINS pDrvIns, PCFGMNODE pCfgHandle);

    int mcAudioRefs;
    volatile uint32_t mcVRDPClients;

#ifdef VRDP_NO_COM
#else
    static DECLCALLBACK(int)    vrdp_ClientLogon (void *pvUser, uint32_t u32ClientId, const char *pszUser, const char *pszPassword, const char *pszDomain);
    static DECLCALLBACK(void)   vrdp_ClientConnect (void *pvUser, uint32_t u32ClientId);
    static DECLCALLBACK(void)   vrdp_ClientDisconnect (void *pvUser, uint32_t u32ClientId, uint32_t fu32Intercepted);
    static DECLCALLBACK(void)   vrdp_InterceptAudio (void *pvUser, uint32_t u32ClientId);
    static DECLCALLBACK(void)   vrdp_InterceptUSB (void *pvUser, uint32_t u32ClientId, PFNVRDPUSBCALLBACK *ppfn, void **ppv);
    static DECLCALLBACK(void)   vrdp_InterceptClipboard (void *pvUser, uint32_t u32ClientId, PFNVRDPCLIPBOARDCALLBACK *ppfn, void **ppv);

    static VRDPSERVERCALLBACK   sVrdpServerCallback;
#endif /* VRDP_NO_COM */

    static const char *sSSMConsoleUnit;
    static uint32_t sSSMConsoleVer;

    HRESULT loadDataFromSavedState();

    static DECLCALLBACK(void)   saveStateFileExec (PSSMHANDLE pSSM, void *pvUser);
    static DECLCALLBACK(int)    loadStateFileExec (PSSMHANDLE pSSM, void *pvUser, uint32_t u32Version);

    bool mSavedStateDataLoaded : 1;

    const ComPtr <IMachine> mMachine;
    const ComPtr <IInternalMachineControl> mControl;

    const ComPtr <IVRDPServer> mVRDPServer;
    const ComPtr <IDVDDrive> mDVDDrive;
    const ComPtr <IFloppyDrive> mFloppyDrive;

    ConsoleVRDPServer * const mConsoleVRDPServer;

    const ComObjPtr <Guest> mGuest;
    const ComObjPtr <Keyboard> mKeyboard;
    const ComObjPtr <Mouse> mMouse;
    const ComObjPtr <Display> mDisplay;
    const ComObjPtr <MachineDebugger> mDebugger;
    const ComObjPtr <RemoteDisplayInfo> mRemoteDisplayInfo;

    USBDeviceList mUSBDevices;
    RemoteUSBDeviceList mRemoteUSBDevices;
    SharedFolderList mSharedFolders;

    /** The VM instance handle. */
    PVM mpVM;
    /** Holds the number of "readonly" mpVM callers (users) */
    uint32_t mVMCallers;
    /** Semaphore posted when the number of mpVM callers drops to zero */
    RTSEMEVENT mVMZeroCallersSem;
    /** true when Console has entered the mpVM destruction phase */
    bool mVMDestroying : 1;

    /** The current DVD drive state in the VM.
     * This does not have to match the state maintained in the DVD. */
    DriveState_T meDVDState;
    /** The current Floppy drive state in the VM.
     * This does not have to match the state maintained in the Floppy. */
    DriveState_T meFloppyState;

    VMMDev * const mVMMDev;
    AudioSniffer * const mAudioSniffer;

    PPDMLED     mapFDLeds[2];
    PPDMLED     mapIDELeds[4];
    PPDMLED     mapNetworkLeds[8];
    PPDMLED     mapSharedFolderLed;
#ifdef VBOX_WITH_UNIXY_TAP_NETWORKING
    Utf8Str     maTAPDeviceName[8];
    RTFILE      maTapFD[8];
#endif

    bool mVMStateChangeCallbackDisabled;

    /* Local machine state value */
    MachineState_T mMachineState;

    typedef std::list <ComPtr <IConsoleCallback> > CallbackList;
    CallbackList mCallbacks;

    struct
    {
        /** OnMousePointerShapeChange() cache */
        struct
        {
            bool valid;
            bool visible;
            bool alpha;
            uint32_t xHot;
            uint32_t yHot;
            uint32_t width;
            uint32_t height;
            BYTE *shape;
            size_t shapeSize;
        }
        mpsc;

        /** OnMouseCapabilityChange() cache */
        struct
        {
            bool valid;
            BOOL supportsAbsolute;
            BOOL needsHostCursor;
        }
        mcc;

        /** OnKeyboardLedsChange() cache */
        struct
        {
            bool valid;
            bool numLock;
            bool capsLock;
            bool scrollLock;
        }
        klc;
    }
    mCallbackData;

    friend struct VMTask;
};

#endif // ____H_CONSOLEIMPL