Global.h revision 7ffe7543b32c5dfd3aede1d7f2c1332c7508f6cc
/* $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;
* 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"
#define VBOXOSHINT_NONE 0
#define VBOXOSHINT_64BIT RT_BIT(0)
/** 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.
*/
{
/** 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 recommendedRAM;
const uint32_t recommendedVRAM;
const uint64_t recommendedHDD;
const uint32_t numSerialEnabled;
const StorageBus_T dvdStorageBusType;
const StorageBus_T hdStorageBusType;
const ChipsetType_T chipsetType;
};
/**
* Maps VBOXOSTYPE to the OS type which is used in VM configs.
*/
/**
* Get the network adapter limit for each chipset type.
*/
/**
* 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()).
*/
{
return aState >= MachineState_FirstOnline &&
}
/**
* 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()).
*/
{
return aState >= MachineState_FirstTransient &&
}
/**
* 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.
*/
{
}
/**
* Stringify a machine state.
*
* @returns Pointer to a read only string.
* @param aState Valid machine state.
*/
/**
* Stringify a session state.
*
* @returns Pointer to a read only string.
* @param aState Valid session state.
*/
/**
* Stringify a device type.
*
* @returns Pointer to a read only string.
* @param aType The device type.
*/
/**
* Stringify a reason.
*
* @returns Pointer to a read only string.
* @param aReason The reason code.
*/
/**
*
* @returns VBox status code.
* @param aComStatus 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.
*/
};
#endif /* !____H_GLOBAL */
/* vi: set tabstop=4 shiftwidth=4 expandtab: */