Global.h revision d4c0b01d95e56701ccb5a430fea1a36dc671153b
/* $Id$ */
/** @file
* VirtualBox COM API - Global Declarations and Definitions.
*/
/*
* Copyright (C) 2008-2011 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* you can redistribute it and/or modify it under the terms of the GNU
* General Public License (GPL) as published by the Free Software
* Foundation, in version 2 as it comes in the "COPYING" file of the
* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
*/
#ifndef ____H_GLOBAL
#define ____H_GLOBAL
/* interface definitions */
#include "VBox/com/VirtualBox.h"
#include <VBox/ostypes.h>
#include <iprt/types.h>
#define VBOXOSHINT_NONE 0
#define VBOXOSHINT_64BIT RT_BIT(0)
#define VBOXOSHINT_HWVIRTEX RT_BIT(1)
#define VBOXOSHINT_IOAPIC RT_BIT(2)
#define VBOXOSHINT_EFI RT_BIT(3)
#define VBOXOSHINT_PAE RT_BIT(4)
#define VBOXOSHINT_USBHID RT_BIT(5)
#define VBOXOSHINT_HPET RT_BIT(6)
#define VBOXOSHINT_USBTABLET RT_BIT(7)
#define VBOXOSHINT_RTCUTC RT_BIT(8)
#define VBOXOSHINT_ACCEL2D RT_BIT(9)
#define VBOXOSHINT_ACCEL3D RT_BIT(10)
#define VBOXOSHINT_FLOPPY RT_BIT(11)
#define VBOXOSHINT_NOUSB RT_BIT(12)
/** The VBoxVRDP kludge extension pack name.
*
* This is not a valid extension pack name (dashes are not allowed), and
* hence will not conflict with real extension packs.
*/
#define VBOXVRDP_KLUDGE_EXTPACK_NAME "Built-in-VBoxVRDP"
/**
* Contains global static definitions that can be referenced by all COM classes
* regardless of the apartment.
*/
class Global
{
public:
/** Represents OS Type <-> string mappings. */
struct OSType
{
const char *familyId; /* utf-8 */
const char *familyDescription; /* utf-8 */
const char *id; /* utf-8, VM config file value */
const char *description; /* utf-8 */
const VBOXOSTYPE osType;
const uint32_t osHint;
const uint32_t recommendedRAM;
const uint32_t recommendedVRAM;
const uint64_t recommendedHDD;
const NetworkAdapterType_T networkAdapterType;
const uint32_t numSerialEnabled;
const StorageControllerType_T dvdStorageControllerType;
const StorageBus_T dvdStorageBusType;
const StorageControllerType_T hdStorageControllerType;
const StorageBus_T hdStorageBusType;
const ChipsetType_T chipsetType;
const AudioControllerType_T audioControllerType;
};
static const OSType sOSTypes[];
static uint32_t cOSTypes;
/**
* Maps VBOXOSTYPE to the OS type which is used in VM configs.
*/
static const char *OSTypeId(VBOXOSTYPE aOSType);
/**
* Get the network adapter limit for each chipset type.
*/
static uint32_t getMaxNetworkAdapters(ChipsetType_T aChipsetType);
/**
* Returns @c true if the given machine state is an online state. This is a
* recommended way to detect if the VM is online (being executed in a
* dedicated process) or not. Note that some online states are also
* transitional states (see #IsTransitional()).
*
* @remarks Saving may actually be an offline state according to the
* documentation (offline snapshot).
*/
static bool IsOnline(MachineState_T aState)
{
#if 0
return aState >= MachineState_FirstOnline &&
aState <= MachineState_LastOnline;
#else
switch (aState)
{
case MachineState_Running:
case MachineState_Paused:
case MachineState_Teleporting:
case MachineState_LiveSnapshotting:
case MachineState_Stuck:
case MachineState_Starting:
case MachineState_Stopping:
case MachineState_Saving:
case MachineState_Restoring:
case MachineState_TeleportingPausedVM:
case MachineState_TeleportingIn:
return true;
default:
return false;
}
#endif
}
/**
* Returns @c true if the given machine state is a transient state. This is
* a recommended way to detect if the VM is performing some potentially
* lengthy operation (such as starting, stopping, saving, deleting
* snapshot, etc.). Note some (but not all) transitional states are also
* online states (see #IsOnline()).
*/
static bool IsTransient(MachineState_T aState)
{
#if 0
return aState >= MachineState_FirstTransient &&
aState <= MachineState_LastTransient;
#else
switch (aState)
{
case MachineState_Teleporting:
case MachineState_LiveSnapshotting:
case MachineState_Starting:
case MachineState_Stopping:
case MachineState_Saving:
case MachineState_Restoring:
case MachineState_TeleportingPausedVM:
case MachineState_TeleportingIn:
case MachineState_RestoringSnapshot:
case MachineState_DeletingSnapshot:
case MachineState_SettingUp:
return true;
default:
return false;
}
#endif
}
/**
* Shortcut to <tt>IsOnline(aState) || IsTransient(aState)</tt>. When it returns
* @false, the VM is turned off (no VM process) and not busy with
* another exclusive operation.
*/
static bool IsOnlineOrTransient(MachineState_T aState)
{
return IsOnline(aState) || IsTransient(aState);
}
/**
* Stringify a machine state.
*
* @returns Pointer to a read only string.
* @param aState Valid machine state.
*/
static const char *stringifyMachineState(MachineState_T aState);
/**
* Stringify a session state.
*
* @returns Pointer to a read only string.
* @param aState Valid session state.
*/
static const char *stringifySessionState(SessionState_T aState);
/**
* Stringify a device type.
*
* @returns Pointer to a read only string.
* @param aType The device type.
*/
static const char *stringifyDeviceType(DeviceType_T aType);
/**
* Try convert a COM status code to a VirtualBox status code (VBox/err.h).
*
* @returns VBox status code.
* @param aComStatus COM status code.
*/
static int vboxStatusCodeFromCOM(HRESULT aComStatus);
/**
* Try convert a VirtualBox status code (VBox/err.h) to a COM status code.
*
* This is mainly intended for dealing with vboxStatusCodeFromCOM() return
* values. If used on anything else, it won't be able to cope with most of the
* input!
*
* @returns COM status code.
* @param aVBoxStatus VBox status code.
*/
static HRESULT vboxStatusCodeToCOM(int aVBoxStatus);
};
#endif /* !____H_GLOBAL */
/* vi: set tabstop=4 shiftwidth=4 expandtab: */