VBox/Main/HostFloppyDriveImpl.cpp

	HostFloppyDriveImpl.cpp revision 26d2a42f095ded346df2e41cc4837cb426b4753a
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/** @file
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * VirtualBox COM class implementation
b2640405e06105d868b5fc8f7b676bb680884380vboxsync */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/*
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * Copyright (C) 2006-2007 Sun Microsystems, Inc.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * available from http://www.virtualbox.org. This file is free software;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * you can redistribute it and/or modify it under the terms of the GNU
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * General Public License (GPL) as published by the Free Software
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * additional information or have any questions.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync#include "HostFloppyDriveImpl.h"
b2640405e06105d868b5fc8f7b676bb680884380vboxsync#include <iprt/cpputils.h>
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync// constructor / destructor
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/////////////////////////////////////////////////////////////////////////////
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncDEFINE_EMPTY_CTOR_DTOR (HostFloppyDrive)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncHRESULT HostFloppyDrive::FinalConstruct()
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    return S_OK;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncvoid HostFloppyDrive::FinalRelease()
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    uninit();
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync// public initializer/uninitializer for internal purposes only
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/////////////////////////////////////////////////////////////////////////////
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/**
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * Initializes the host floppy drive object.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * @param aName         Name of the drive.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * @param aUdi          Universal device identifier (currently may be NULL).
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * @param aDescription  Human-readable drive description (may be NULL).
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *
b2640405e06105d868b5fc8f7b676bb680884380vboxsync * @return COM result indicator.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync */
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncHRESULT HostFloppyDrive::init (INPTR BSTR aName,
b2640405e06105d868b5fc8f7b676bb680884380vboxsync                               INPTR BSTR aUdi /* = NULL */,
b2640405e06105d868b5fc8f7b676bb680884380vboxsync                               INPTR BSTR aDescription /* = NULL */)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    ComAssertRet (aName, E_INVALIDARG);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    /* Enclose the state transition NotReady->InInit->Ready */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    AutoInitSpan autoInitSpan (this);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    AssertReturn (autoInitSpan.isOk(), E_FAIL);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    unconst (mName) = aName;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    unconst (mUdi) = aUdi;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    unconst (mDescription) = aDescription;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    /* Confirm the successful initialization */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    autoInitSpan.setSucceeded();
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    return S_OK;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/**
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *  Uninitializes the instance and sets the ready flag to FALSE.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync *  Called either from FinalRelease() or by the parent when it gets destroyed.
b2640405e06105d868b5fc8f7b676bb680884380vboxsync */
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncvoid HostFloppyDrive::uninit()
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    /* Enclose the state transition Ready->InUninit->NotReady */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    AutoUninitSpan autoUninitSpan (this);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    if (autoUninitSpan.uninitDone())
b2640405e06105d868b5fc8f7b676bb680884380vboxsync        return;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    unconst (mName).setNull();
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync// IHostFloppyDrive properties
b2640405e06105d868b5fc8f7b676bb680884380vboxsync/////////////////////////////////////////////////////////////////////////////
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncSTDMETHODIMP HostFloppyDrive::COMGETTER(Name) (BSTR *aName)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    if (!aName)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync        return E_POINTER;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    AutoCaller autoCaller (this);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    CheckComRCReturnRC (autoCaller.rc());
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    /* mName is constant during life time, no need to lock */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    mName.cloneTo (aName);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    return S_OK;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncSTDMETHODIMP HostFloppyDrive::COMGETTER(Description) (BSTR *aDescription)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    if (!aDescription)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync        return E_POINTER;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    AutoCaller autoCaller (this);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    CheckComRCReturnRC (autoCaller.rc());
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    /* mDescription is constant during life time, no need to lock */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    mDescription.cloneTo (aDescription);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    return S_OK;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsyncSTDMETHODIMP HostFloppyDrive::COMGETTER(Udi) (BSTR *aUdi)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync{
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    if (!aUdi)
b2640405e06105d868b5fc8f7b676bb680884380vboxsync        return E_POINTER;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    AutoCaller autoCaller (this);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    CheckComRCReturnRC (autoCaller.rc());
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    /* mUdi is constant during life time, no need to lock */
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    mUdi.cloneTo (aUdi);
b2640405e06105d868b5fc8f7b676bb680884380vboxsync
b2640405e06105d868b5fc8f7b676bb680884380vboxsync    return S_OK;
b2640405e06105d868b5fc8f7b676bb680884380vboxsync}
b2640405e06105d868b5fc8f7b676bb680884380vboxsync