Changeset 65120 in vbox for trunk/src/VBox/Main
- Timestamp:
- Jan 4, 2017 5:10:35 PM (8 years ago)
- Location:
- trunk/src/VBox/Main
- Files:
-
- 25 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/VBox/Main/include/Global.h
r63431 r65120 122 122 /** 123 123 * Shortcut to <tt>IsOnline(aState) || IsTransient(aState)</tt>. When it returns 124 * @ false, the VM is turned off (no VM process) and not busy with124 * @c false, the VM is turned off (no VM process) and not busy with 125 125 * another exclusive operation. 126 126 */ -
trunk/src/VBox/Main/include/HostNetworkInterfaceImpl.h
r62485 r65120 40 40 41 41 // public initializer/uninitializer for internal purposes only 42 HRESULT init(Bstr interfaceName, Bstr shortName, Guid guid, HostNetworkInterfaceType_T ifType);42 HRESULT init(Bstr aInterfaceName, Bstr aShortName, Guid aGuid, HostNetworkInterfaceType_T ifType); 43 43 #ifdef VBOX_WITH_HOSTNETIF_API 44 44 HRESULT init(Bstr aInterfaceName, HostNetworkInterfaceType_T ifType, struct NETIFINFO *pIfs); -
trunk/src/VBox/Main/src-all/ExtPackManagerImpl.cpp
r63239 r65120 2615 2615 * fail. 2616 2616 * @param a_pstrDisplayInfo Host specific display information hacks. 2617 * @param a_ppProgress Where to return a progress object some day. Can2618 2617 * be NULL. 2619 2618 */ … … 3043 3042 * @param a_pszModuleName The library. 3044 3043 * @param a_pszExtPack The extension pack. 3045 * @param a_pstr VrdeLibraryWhere to return the path.3044 * @param a_pstrLibrary Where to return the path. 3046 3045 */ 3047 3046 HRESULT ExtPackManager::i_getLibraryPathForExtPack(const char *a_pszModuleName, const char *a_pszExtPack, Utf8Str *a_pstrLibrary) -
trunk/src/VBox/Main/src-all/VirtualBoxBase.cpp
r65088 r65120 215 215 * @endcode 216 216 * 217 * @param aThis 218 * @param RT_SRC_POS_DECL"RT_SRC_POS" macro instantiation.217 * @param aThis object where the exception happened 218 * @param SRC_POS "RT_SRC_POS" macro instantiation. 219 219 * */ 220 220 /* static */ -
trunk/src/VBox/Main/src-client/ConsoleImpl.cpp
r65103 r65120 1568 1568 * called when the user saves the VM state. 1569 1569 * 1570 * @param pvUser pointer to Console 1570 * @param pSSM SSM handle. 1571 * @param pvUser pointer to Console 1571 1572 * 1572 1573 * @note Locks the Console object for reading. … … 1622 1623 * Called when the VM is being restored from the saved state. 1623 1624 * 1625 * @param pSSM SSM handle. 1624 1626 * @param pvUser pointer to Console 1625 1627 * @param uVersion Console unit version. … … 1648 1650 /** 1649 1651 * Method to load various console data from the state file. 1650 * Called from # loadDataFromSavedState.1651 * 1652 * @param p vUser pointer to Console1652 * Called from #i_loadDataFromSavedState. 1653 * 1654 * @param pSSM SSM handle. 1653 1655 * @param u32Version Console unit version. 1654 1656 * Should match sSSMConsoleVer. … … 3320 3322 * @param pAlock The automatic lock instance. This is for when we have 3321 3323 * to leave it in order to avoid deadlocks. 3322 * @param pf Suspendwhere to store the information if we need to resume3324 * @param pfResume where to store the information if we need to resume 3323 3325 * afterwards. 3324 3326 */ … … 3516 3518 * @param pcszDevice The PDM device name. 3517 3519 * @param uInstance The PDM device instance. 3518 * @param uLun The PDM LUN number of the drive. 3519 * @param fHostDrive True if this is a host drive attachment. 3520 * @param pszPath The path to the media / drive which is now being mounted / captured. 3521 * If NULL no media or drive is attached and the LUN will be configured with 3522 * the default block driver with no media. This will also be the state if 3523 * mounting / capturing the specified media / drive fails. 3524 * @param pszFormat Medium format string, usually "RAW". 3525 * @param fPassthrough Enables using passthrough mode of the host DVD drive if applicable. 3520 * @param enmBus The storage bus type of the controller. 3521 * @param fUseHostIOCache Whether to use the host I/O cache (disable async I/O). 3522 * @param aMediumAtt The medium attachment. 3523 * @param fForce Force unmounting. 3526 3524 * 3527 3525 * @thread EMT … … 3698 3696 * @param pcszDevice The PDM device name. 3699 3697 * @param uInstance The PDM device instance. 3698 * @param enmBus The storage bus type of the controller. 3699 * @param fUseHostIOCache Whether to use the host I/O cache (disable async I/O). 3700 * @param aMediumAtt The medium attachment. 3700 3701 * @param fSilent Flag whether to inform the guest about the attached device. 3701 3702 * … … 3868 3869 * @param pcszDevice The PDM device name. 3869 3870 * @param uInstance The PDM device instance. 3871 * @param enmBus The storage bus type of the controller. 3872 * @param pMediumAtt Pointer to the medium attachment. 3870 3873 * @param fSilent Flag whether to notify the guest about the detached device. 3871 3874 * … … 4427 4430 * 4428 4431 * @returns COM status code. 4429 * @param aId The ID to look for.4432 * @param strId The ID to look for. 4430 4433 */ 4431 4434 HRESULT Console::i_clearDiskEncryptionKeysOnAllAttachmentsWithKeyId(const Utf8Str &strId) … … 4688 4691 * Parses the encryption configuration for one disk. 4689 4692 * 4690 * @returns Pointer to the string following encryption configuration. 4691 * @param psz Pointer to the configuration for the encryption of one disk. 4693 * @returns COM status code. 4694 * @param psz Pointer to the configuration for the encryption of one disk. 4695 * @param ppszEnd Pointer to the string following encrpytion configuration. 4692 4696 */ 4693 4697 HRESULT Console::i_consoleParseDiskEncryption(const char *psz, const char **ppszEnd) … … 5449 5453 * @return failure if not attached. 5450 5454 * 5451 * @param aDevice 5452 * The device in question.5453 * @param aMaskedIfs 5454 * The interfaces to hide from the guest.5455 * @param aDevice The device in question. 5456 * @param aError Error information. 5457 * @param aMaskedIfs The interfaces to hide from the guest. 5458 * @param aCaptureFilename File name where to store the USB traffic. 5455 5459 * 5456 5460 * @note Locks this object for writing. … … 7870 7874 * in the collection of shared folders. 7871 7875 * 7872 * @param aNamelogical name of the shared folder7876 * @param strName logical name of the shared folder 7873 7877 * @param aSharedFolder where to return the found object 7874 7878 * @param aSetError whether to set the error info if the folder is … … 8047 8051 * shared folders and then in the list of the global shared folders. 8048 8052 * 8049 * @param aNameName of the folder to search for.8053 * @param strName Name of the folder to search for. 8050 8054 * @param aIt Where to store the pointer to the found folder. 8051 8055 * @return @c true if the folder was found and @c false otherwise. … … 8075 8079 * Calls the HGCM service to add a shared folder definition. 8076 8080 * 8077 * @param aNameShared folder name.8078 * @param a HostPath Shared folder path.8081 * @param strName Shared folder name. 8082 * @param aData Shared folder data. 8079 8083 * 8080 8084 * @note Must be called from under AutoVMCaller and when mpUVM != NULL! … … 8188 8192 * Calls the HGCM service to remove the shared folder definition. 8189 8193 * 8190 * @param aNameShared folder name.8194 * @param strName Shared folder name. 8191 8195 * 8192 8196 * @note Must be called from under AutoVMCaller and when mpUVM != NULL! … … 9220 9224 /*static*/ DECLCALLBACK(void) 9221 9225 Console::i_genericVMSetErrorCallback(PUVM pUVM, void *pvUser, int rc, RT_SRC_POS_DECL, 9222 const char *psz ErrorFmt, va_list va)9226 const char *pszFormat, va_list args) 9223 9227 { 9224 9228 RT_SRC_POS_NOREF(); … … 9228 9232 /* We ignore RT_SRC_POS_DECL arguments to avoid confusion of end-users. */ 9229 9233 va_list va2; 9230 va_copy(va2, va);9234 va_copy(va2, args); 9231 9235 9232 9236 /* Append to any the existing error message. */ 9233 9237 if (pErrorText->length()) 9234 9238 *pErrorText = Utf8StrFmt("%s.\n%N (%Rrc)", pErrorText->c_str(), 9235 psz ErrorFmt, &va2, rc, rc);9239 pszFormat, &va2, rc, rc); 9236 9240 else 9237 *pErrorText = Utf8StrFmt("%N (%Rrc)", psz ErrorFmt, &va2, rc, rc);9241 *pErrorText = Utf8StrFmt("%N (%Rrc)", pszFormat, &va2, rc, rc); 9238 9242 9239 9243 va_end(va2); … … 9952 9956 * @param pThis Reference to the console object. 9953 9957 * @param pUVM The VM handle. 9954 * @param lInstance The instance of the controller.9955 9958 * @param pcszDevice The name of the controller type. 9959 * @param uInstance The instance of the controller. 9956 9960 * @param enmBus The storage bus type of the controller. 9961 * @param fUseHostIOCache Use the host I/O cache (disable async I/O). 9962 * @param fBuiltinIOCache Use the builtin I/O cache. 9957 9963 * @param fSetupMerge Whether to set up a medium merge 9958 9964 * @param uMergeSource Merge source image index -
trunk/src/VBox/Main/src-client/ConsoleImpl2.cpp
r65088 r65120 4013 4013 * @param enmBus The storage bus. 4014 4014 * @param enmDevType The device type. 4015 * @param pc zsDevice The device emulation.4015 * @param pcszDevice The device emulation. 4016 4016 * @param uInstance Instance of the device. 4017 4017 * @param uLUN The LUN on the device. 4018 * @param fForceUnmount Whether to force unmounting. 4018 4019 */ 4019 4020 int Console::i_unmountMediumFromGuest(PUVM pUVM, StorageBus_T enmBus, DeviceType_T enmDevType, … … 4061 4062 * @returns VBox status code. 4062 4063 * @param pCtlInst The controler instance node in the CFGM tree. 4063 * @param pc zsDevice The device name.4064 * @param pcszDevice The device name. 4064 4065 * @param uInstance The device instance. 4065 4066 * @param uLUN The device LUN. -
trunk/src/VBox/Main/src-client/ConsoleImplTeleporter.cpp
r65088 r65120 189 189 { 190 190 char *pszStart = pszBuf; 191 RTSOCKET Sock= pState->mhSocket;191 RTSOCKET hSocket = pState->mhSocket; 192 192 193 193 AssertReturn(cchBuf > 1, VERR_INTERNAL_ERROR); … … 198 198 { 199 199 char ch; 200 int rc = RTTcpRead( Sock, &ch, sizeof(ch), NULL);200 int rc = RTTcpRead(hSocket, &ch, sizeof(ch), NULL); 201 201 if (RT_FAILURE(rc)) 202 202 { … … 932 932 * 933 933 * @param aHostname The name of the target host. 934 * @param a PortThe TCP port number.934 * @param aTcpport The TCP port number. 935 935 * @param aPassword The password. 936 936 * @param aMaxDowntime Max allowed "downtime" in milliseconds. … … 1257 1257 */ 1258 1258 /*static*/ DECLCALLBACK(int) 1259 Console::i_teleporterTrgServeConnection(RTSOCKET Sock, void *pvUser)1259 Console::i_teleporterTrgServeConnection(RTSOCKET hSocket, void *pvUser) 1260 1260 { 1261 1261 TeleporterStateTrg *pState = (TeleporterStateTrg *)pvUser; 1262 pState->mhSocket = Sock;1262 pState->mhSocket = hSocket; 1263 1263 1264 1264 /* … … 1267 1267 int vrc = RTTcpSetSendCoalescing(pState->mhSocket, false /*fEnable*/); 1268 1268 AssertRC(vrc); 1269 vrc = RTTcpWrite( Sock, g_szWelcome, sizeof(g_szWelcome) - 1);1269 vrc = RTTcpWrite(hSocket, g_szWelcome, sizeof(g_szWelcome) - 1); 1270 1270 if (RT_FAILURE(vrc)) 1271 1271 { … … 1282 1282 { 1283 1283 char ch; 1284 vrc = RTTcpRead( Sock, &ch, sizeof(ch), NULL);1284 vrc = RTTcpRead(hSocket, &ch, sizeof(ch), NULL); 1285 1285 if ( RT_FAILURE(vrc) 1286 1286 || pszPassword[off] != ch) … … 1304 1304 HRESULT hrc; 1305 1305 RTNETADDR Addr; 1306 vrc = RTTcpGetPeerAddress( Sock, &Addr);1306 vrc = RTTcpGetPeerAddress(hSocket, &Addr); 1307 1307 if (RT_SUCCESS(vrc)) 1308 1308 { -
trunk/src/VBox/Main/src-client/DisplayImpl.cpp
r64105 r65120 607 607 * 608 608 * @returns COM result indicator 609 * @param parent handle of our parent object 610 * @param qemuConsoleData address of common console data structure 609 * @param aParent handle of our parent object 611 610 */ 612 611 HRESULT Display::init(Console *aParent) … … 891 890 * Handles display resize event. 892 891 * 893 * @param w New display width 894 * @param h New display height 892 * @param uScreenId Screen ID 893 * @param bpp New bits per pixel. 894 * @param pvVRAM VRAM pointer. 895 * @param cbLine New bytes per line. 896 * @param w New display width. 897 * @param h New display height. 898 * @param flags Flags of the new video mode. 895 899 * 896 * 900 * @thread EMT 897 901 */ 898 902 int Display::i_handleDisplayResize(unsigned uScreenId, uint32_t bpp, void *pvVRAM, -
trunk/src/VBox/Main/src-client/GuestImpl.cpp
r63418 r65120 742 742 * Returns the status of a specified Guest Additions facility. 743 743 * 744 * @return aStatus Current status of specified facility.745 * @param a TypeFacility to get the status from.744 * @return COM status code 745 * @param aFacility Facility to get the status from. 746 746 * @param aTimestamp Timestamp of last facility status update in ms (optional). 747 * @param aStatus Current status of the specified facility. 747 748 */ 748 749 HRESULT Guest::getFacilityStatus(AdditionsFacilityType_T aFacility, LONG64 *aTimestamp, AdditionsFacilityStatus_T *aStatus) … … 1047 1048 * Gets called by vmmdevUpdateGuestStatus, which just passes the report along. 1048 1049 * 1049 * @param a_pInterface Pointer to this interface.1050 1050 * @param a_enmFacility The facility. 1051 1051 * @param a_enmStatus The status. … … 1092 1092 * Sets the supported features (and whether they are active or not). 1093 1093 * 1094 * @param fCapsGuest capability bit mask (VMMDEV_GUEST_SUPPORTS_XXX).1094 * @param aCaps Guest capability bit mask (VMMDEV_GUEST_SUPPORTS_XXX). 1095 1095 */ 1096 1096 void Guest::i_setSupportedFeatures(uint32_t aCaps) -
trunk/src/VBox/Main/src-client/GuestProcessImpl.cpp
r65088 r65120 2470 2470 * Converts a toolbox tool's exit code to an IPRT error code. 2471 2471 * 2472 * @return intReturned IPRT error for the particular tool.2473 * @param pszTool 2474 * @param rcExitThe toolbox tool's exit code to lookup IPRT error for.2472 * @return Returned IPRT error for the particular tool. 2473 * @param pszTool Name of toolbox tool to lookup error code for. 2474 * @param lExitCode The toolbox tool's exit code to lookup IPRT error for. 2475 2475 */ 2476 2476 /* static */ -
trunk/src/VBox/Main/src-client/GuestSessionImpl.cpp
r64101 r65120 1952 1952 procInfo.mTimeoutMS = UINT32_MAX; 1953 1953 1954 /** @to odImplement process priority + affinity. */1954 /** @todo Implement process priority + affinity. */ 1955 1955 1956 1956 AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS); -
trunk/src/VBox/Main/src-client/KeyboardImpl.cpp
r63244 r65120 96 96 * 97 97 * @returns COM result indicator 98 * @param parenthandle of our parent object98 * @param aParent handle of our parent object 99 99 */ 100 100 HRESULT Keyboard::init(Console *aParent) -
trunk/src/VBox/Main/src-client/MachineDebuggerImpl.cpp
r65103 r65120 124 124 * 125 125 * @returns COM status code 126 * @param a _fEnabledWhere to store the result.126 * @param aSingleStep Where to store the result. 127 127 */ 128 128 HRESULT MachineDebugger::getSingleStep(BOOL *aSingleStep) … … 533 533 * 534 534 * @returns COM status code 535 * @param a Enabledaddress of result variable535 * @param aHWVirtExEnabled address of result variable 536 536 */ 537 537 HRESULT MachineDebugger::getHWVirtExEnabled(BOOL *aHWVirtExEnabled) … … 553 553 * 554 554 * @returns COM status code 555 * @param a Enabledaddress of result variable555 * @param aHWVirtExNestedPagingEnabled address of result variable 556 556 */ 557 557 HRESULT MachineDebugger::getHWVirtExNestedPagingEnabled(BOOL *aHWVirtExNestedPagingEnabled) … … 573 573 * 574 574 * @returns COM status code 575 * @param a Enabled address of result variable575 * @param aHWVirtExVPIDEnabled address of result variable 576 576 */ 577 577 HRESULT MachineDebugger::getHWVirtExVPIDEnabled(BOOL *aHWVirtExVPIDEnabled) -
trunk/src/VBox/Main/src-server/ApplianceImplExport.cpp
r63563 r65120 53 53 /** 54 54 * Public method implementation. 55 * @param appliance 55 * @param aAppliance Appliance object. 56 * @param aLocation Where to store the appliance. 57 * @param aDescription Appliance description. 56 58 * @return 57 59 */ … … 618 620 /** 619 621 * Public method implementation. 620 * @param format621 * @param options622 * @param path623 * @param aProgress 622 * @param aFormat Appliance format. 623 * @param aOptions Export options. 624 * @param aPath Path to write the appliance to. 625 * @param aProgress Progress object. 624 626 * @return 625 627 */ -
trunk/src/VBox/Main/src-server/ApplianceImplImport.cpp
r65088 r65120 68 68 * Thread implementation is in Appliance::readImpl(). 69 69 * 70 * @param aFile 70 * @param aFile File to read the appliance from. 71 * @param aProgress Progress object. 71 72 * @return 72 73 */ … … 752 753 * VirtualSystemScription instances created by Appliance::Interpret(). 753 754 * Thread implementation is in Appliance::i_importImpl(). 754 * @param aProgress 755 * @param aOptions Import options. 756 * @param aProgress Progress object. 755 757 * @return 756 758 */ -
trunk/src/VBox/Main/src-server/BandwidthGroupImpl.cpp
r61169 r65120 90 90 91 91 /** 92 * Initializes the object given another object 93 * (a kind of copy constructor). This object shares data with 94 * the object passed as an argument. 95 * 96 * @param aReshare 97 * When false, the original object will remain a data owner. 98 * Otherwise, data ownership will be transferred from the original 99 * object to this one. 100 * 101 * @note This object must be destroyed before the original object 102 * it shares data with is destroyed. 103 * 104 * @note Locks @a aThat object for writing if @a aReshare is @c true, or for 105 * reading if @a aReshare is false. 92 * Initializes the object given another object 93 * (a kind of copy constructor). This object shares data with 94 * the object passed as an argument. 95 * 96 * @param aParent Pointer to our parent object. 97 * @param aThat 98 * @param aReshare 99 * When false, the original object will remain a data owner. 100 * Otherwise, data ownership will be transferred from the original 101 * object to this one. 102 * 103 * @note This object must be destroyed before the original object 104 * it shares data with is destroyed. 105 * 106 * @note Locks @a aThat object for writing if @a aReshare is @c true, or for 107 * reading if @a aReshare is false. 106 108 */ 107 109 HRESULT BandwidthGroup::init(BandwidthControl *aParent, -
trunk/src/VBox/Main/src-server/GuestOSTypeImpl.cpp
r62485 r65120 65 65 * 66 66 * @returns COM result indicator 67 * @param aFamilyId os family short name string 68 * @param aFamilyDescription os family name string 69 * @param aId os short name string 70 * @param aDescription os name string 71 * @param aOSType global OS type ID 72 * @param aOSHint os configuration hint 73 * @param aRAMSize recommended RAM size in megabytes 74 * @param aVRAMSize recommended video memory size in megabytes 75 * @param aHDDSize recommended HDD size in bytes 67 * @param ostype containing the following parts: 68 * @a aFamilyId os family short name string 69 * @a aFamilyDescription os family name string 70 * @a aId os short name string 71 * @a aDescription os name string 72 * @a aOSType global OS type ID 73 * @a aOSHint os configuration hint 74 * @a aRAMSize recommended RAM size in megabytes 75 * @a aVRAMSize recommended video memory size in megabytes 76 * @a aHDDSize recommended HDD size in bytes 76 77 */ 77 HRESULT GuestOSType::init(const Global::OSType &ostype)/*const char *aFamilyId, const char *aFamilyDescription, 78 const char *aId, const char *aDescription, 79 VBOXOSTYPE aOSType, uint32_t aOSHint, 80 uint32_t aRAMSize, uint32_t aVRAMSize, uint64_t aHDDSize, 81 NetworkAdapterType_T aNetworkAdapterType, 82 uint32_t aNumSerialEnabled, 83 StorageControllerType_T aDVDStorageControllerType, 84 StorageBus_T aDVDStorageBusType, 85 StorageControllerType_T aHDStorageControllerType, 86 StorageBus_T aHDStorageBusType, 87 ChipsetType_T aChipsetType 88 AudioControllerType_T aAudioControllerType*/ 89 { 90 #if 0 91 LogFlowThisFunc(("aFamilyId='%s', aFamilyDescription='%s', " 92 "aId='%s', aDescription='%s', " 93 "aType=%d, aOSHint=%x, " 94 "aRAMSize=%d, aVRAMSize=%d, aHDDSize=%lld, " 95 "aNetworkAdapterType=%d, aNumSerialEnabled=%d, " 96 "aStorageControllerType=%d\n", 97 aFamilyId, aFamilyDescription, 98 aId, aDescription, 99 aOSType, aOSHint, 100 aRAMSize, aVRAMSize, aHDDSize, 101 aNetworkAdapterType, 102 aNumSerialEnabled, 103 aStorageControllerType)); 104 #endif 105 78 HRESULT GuestOSType::init(const Global::OSType &ostype) 79 { 106 80 ComAssertRet(ostype.familyId && ostype.familyDescription && ostype.id && ostype.description, E_INVALIDARG); 107 81 -
trunk/src/VBox/Main/src-server/HostImpl.cpp
r65088 r65120 537 537 * 538 538 * @returns COM status code 539 * @param drivesaddress of result pointer539 * @param aDVDDrives address of result pointer 540 540 */ 541 541 … … 561 561 * 562 562 * @returns COM status code 563 * @param drivesaddress of result pointer563 * @param aFloppyDrives address of result pointer 564 564 */ 565 565 HRESULT Host::getFloppyDrives(std::vector<ComPtr<IMedium> > &aFloppyDrives) … … 628 628 * 629 629 * @returns COM status code 630 * @param drivesaddress of result pointer630 * @param aNetworkInterfaces address of result pointer 631 631 */ 632 632 HRESULT Host::getNetworkInterfaces(std::vector<ComPtr<IHostNetworkInterface> > &aNetworkInterfaces) … … 900 900 * 901 901 * @returns COM status code 902 * @param countaddress of result variable902 * @param aCount address of result variable 903 903 */ 904 904 … … 915 915 * 916 916 * @returns COM status code 917 * @param countaddress of result variable917 * @param aCount address of result variable 918 918 */ 919 919 HRESULT Host::getProcessorOnlineCount(ULONG *aCount) … … 929 929 * 930 930 * @returns COM status code 931 * @param countaddress of result variable931 * @param aCount address of result variable 932 932 */ 933 933 HRESULT Host::getProcessorCoreCount(ULONG *aCount) … … 943 943 * 944 944 * @returns COM status code 945 * @param countaddress of result variable945 * @param aCount address of result variable 946 946 */ 947 947 HRESULT Host::getProcessorOnlineCoreCount(ULONG *aCount) … … 957 957 * 958 958 * @returns COM status code 959 * @param cpu id to get info for. 960 * @param speed address of result variable, speed is 0 if unknown or aCpuId is invalid. 959 * @param aCpuId id to get info for. 960 * @param aSpeed address of result variable, speed is 0 if unknown or aCpuId 961 * is invalid. 961 962 */ 962 963 HRESULT Host::getProcessorSpeed(ULONG aCpuId, … … 973 974 * 974 975 * @returns COM status code 975 * @param cpu id to get info for. 976 * @param description address of result variable, empty string if not known or aCpuId is invalid. 976 * @param aCpuId id to get info for. 977 * @param aDescription address of result variable, empty string if not known 978 * or aCpuId is invalid. 977 979 */ 978 980 HRESULT Host::getProcessorDescription(ULONG aCpuId, com::Utf8Str &aDescription) … … 995 997 * 996 998 * @returns COM status code 997 * @param Featureto query.998 * @param a ddress ofsupported bool result variable999 * @param aFeature to query. 1000 * @param aSupported supported bool result variable 999 1001 */ 1000 1002 HRESULT Host::getProcessorFeature(ProcessorFeature_T aFeature, BOOL *aSupported) … … 1118 1120 * 1119 1121 * @returns COM status code 1120 * @param sizeaddress of result variable1122 * @param aSize address of result variable 1121 1123 */ 1122 1124 HRESULT Host::getMemorySize(ULONG *aSize) … … 1136 1138 * 1137 1139 * @returns COM status code 1138 * @param a vailableaddress of result variable1140 * @param aAvailable address of result variable 1139 1141 */ 1140 1142 HRESULT Host::getMemoryAvailable(ULONG *aAvailable) … … 1172 1174 * 1173 1175 * @returns COM status code 1174 * @param osaddress of result variable1176 * @param aVersion address of result variable 1175 1177 */ 1176 1178 HRESULT Host::getOSVersion(com::Utf8Str &aVersion) … … 1207 1209 * 1208 1210 * @returns COM status code 1209 * @param timeaddress of result variable1211 * @param aUTCTime address of result variable 1210 1212 */ 1211 1213 HRESULT Host::getUTCTime(LONG64 *aUTCTime) … … 2049 2051 /** 2050 2052 * Called from getDrives() to build the DVD drives list. 2051 * @param pll2053 * @param list Media list 2052 2054 * @return 2053 2055 */ -
trunk/src/VBox/Main/src-server/HostNetworkInterfaceImpl.cpp
r65088 r65120 65 65 * @returns COM result indicator 66 66 * @param aInterfaceName name of the network interface 67 * @param aGuid GUID of the host network interface 68 * @param ifType interface type 67 * @param aShortName short name of the network interface 68 * @param aGuid GUID of the host network interface 69 * @param ifType interface type 69 70 */ 70 71 HRESULT HostNetworkInterface::init(Bstr aInterfaceName, Bstr aShortName, Guid aGuid, HostNetworkInterfaceType_T ifType) … … 274 275 * 275 276 * @returns COM status code 276 * @param aGuid GUI Id277 */ 278 HRESULT HostNetworkInterface::getId(com::Guid &aGui Id)279 { 280 aGui Id = mGuid;277 * @param aGuid GUID 278 */ 279 HRESULT HostNetworkInterface::getId(com::Guid &aGuid) 280 { 281 aGuid = mGuid; 281 282 282 283 return S_OK; -
trunk/src/VBox/Main/src-server/HostUSBDeviceImpl.cpp
r63174 r65120 509 509 * 510 510 * @param aMachine Machine this device should be attach to. 511 * @param aCaptureFilename Filename to capture the USB traffic to. 511 512 * @param aMaskedIfs The interfaces to hide from the guest. 512 513 */ … … 2231 2232 2232 2233 * @param aNewState The new state (transitional). 2233 * @param aFinalS ubStateThe final state of the transition (non-transitional).2234 * @param aFinalState The final state of the transition (non-transitional). 2234 2235 * @param aNewSubState The new sub-state when applicable. 2235 2236 * -
trunk/src/VBox/Main/src-server/MachineImpl.cpp
r65063 r65120 286 286 * @param aId UUID for the new machine. 287 287 * @param fForceOverwrite Whether to overwrite an existing machine settings file. 288 * @param fDirectoryIncludesUUID Whether the use a special VM directory naming 289 * scheme (includes the UUID). 288 290 * 289 291 * @return Success indicator. if not S_OK, the machine object is invalid … … 407 409 * 408 410 * @param aParent Associated parent object 409 * @param aConfigFileLocal file system path to the VM settings file (can411 * @param strConfigFile Local file system path to the VM settings file (can 410 412 * be relative to the VirtualBox config directory). 411 413 * @param aId UUID of the machine or NULL (see above). … … 518 520 * config is ignored and we always generate a fresh one. 519 521 * 522 * @param aParent Associated parent object. 520 523 * @param strName Name for the new machine; this overrides what is specified in config and is used 521 524 * for the settings file as well. … … 610 613 /** 611 614 * Shared code between the various init() implementations. 612 * @param aParent 615 * @param aParent The VirtualBox object. 616 * @param strConfigFile Settings file. 613 617 * @return 614 618 */ … … 7255 7259 * Adds the given IsModified_* flag to the dirty flags of the machine. 7256 7260 * This must be called either during i_loadSettings or under the machine write lock. 7257 * @param fl 7261 * @param fl Flag 7262 * @param fAllowStateModification If state modifications are allowed. 7258 7263 */ 7259 7264 void Machine::i_setModified(uint32_t fl, bool fAllowStateModification /* = true */) … … 7268 7273 * care of the write locking. 7269 7274 * 7270 * @param fModifications The flag to add. 7275 * @param fModification The flag to add. 7276 * @param fAllowStateModification If state modifications are allowed. 7271 7277 */ 7272 7278 void Machine::i_setModifiedLock(uint32_t fModification, bool fAllowStateModification /* = true */) … … 7279 7285 * Saves the registry entry of this machine to the given configuration node. 7280 7286 * 7281 * @param aEntryNode Node to save the registry entry to.7287 * @param data Machine registry data. 7282 7288 * 7283 7289 * @note locks this object for reading. … … 7300 7306 * machine settings file as the current directory. 7301 7307 * 7302 * @param aPathPath to calculate the absolute path for.7308 * @param strPath Path to calculate the absolute path for. 7303 7309 * @param aResult Where to put the result (used only on success, can be the 7304 7310 * same Utf8Str instance as passed in @a aPath). … … 7453 7459 * So instead we now use a timestamp. 7454 7460 * 7455 * @param str 7461 * @param strStateFilePath 7456 7462 */ 7457 7463 … … 8891 8897 * Loads settings into mHWData. 8892 8898 * 8893 * @param data Reference to the hardware settings. 8894 * @param pDbg Pointer to the debugging settings. 8895 * @param pAutostart Pointer to the autostart settings. 8899 * @param puuidRegistry Registry ID. 8900 * @param puuidSnapshot Snapshot ID 8901 * @param data Reference to the hardware settings. 8902 * @param pDbg Pointer to the debugging settings. 8903 * @param pAutostart Pointer to the autostart settings. 8896 8904 */ 8897 8905 HRESULT Machine::i_loadHardware(const Guid *puuidRegistry, … … 9301 9309 * Called from i_loadStorageControllers for a controller's devices. 9302 9310 * 9303 * @param aStorageController 9304 * @param data 9305 * @param puuidRegistry media registry ID to set media to or NULL; see Machine::i_loadMachineDataFromSettings() 9306 * @param aSnapshotId pointer to the snapshot ID if this is a snapshot machine 9311 * @param aStorageController 9312 * @param data 9313 * @param puuidRegistry media registry ID to set media to or NULL; see 9314 * Machine::i_loadMachineDataFromSettings() 9315 * @param puuidSnapshot pointer to the snapshot ID if this is a snapshot machine 9307 9316 * @return 9308 9317 */ … … 9572 9581 * Returns the snapshot with the given name or fails of no such snapshot. 9573 9582 * 9574 * @param aNamesnapshot name to find9583 * @param strName snapshot name to find 9575 9584 * @param aSnapshot where to return the found snapshot 9576 9585 * @param aSetError true to set extended error info on failure … … 9965 9974 * saved and the global machine and media registries will therefore need 9966 9975 * updating. 9976 * @param aFlags Flags. 9967 9977 */ 9968 9978 HRESULT Machine::i_saveSettings(bool *pfNeedsGlobalSaveSettings, … … 10728 10738 * many operations left as the number of hard disks 10729 10739 * attached). 10740 * @param aWeight Weight of this operation. 10730 10741 * @param aOnline Whether the VM was online prior to this operation. 10731 10742 * … … 11186 11197 * can be searched as well if needed. 11187 11198 * 11188 * @param l ist11199 * @param ll 11189 11200 * @param aControllerName 11190 11201 * @param aControllerPort … … 11212 11223 * can be searched as well if needed. 11213 11224 * 11214 * @param list 11215 * @param aControllerName 11216 * @param aControllerPort 11217 * @param aDevice 11225 * @param ll 11226 * @param pMedium 11218 11227 * @return 11219 11228 */ … … 11237 11246 * can be searched as well if needed. 11238 11247 * 11239 * @param list 11240 * @param aControllerName 11241 * @param aControllerPort 11242 * @param aDevice 11248 * @param ll 11249 * @param id 11243 11250 * @return 11244 11251 */ … … 11261 11268 * from Machine::prepareUnregister() so it has been taken out for simplicity. 11262 11269 * 11263 * @param pAttach Medium attachment to detach. 11264 * @param writeLock Machine write lock which the caller must have locked once. This may be released temporarily in here. 11265 * @param pSnapshot If NULL, then the detachment is for the current machine. Otherwise this is for a 11266 * SnapshotMachine, and this must be its snapshot. 11270 * @param pAttach Medium attachment to detach. 11271 * @param writeLock Machine write lock which the caller must have locked once. 11272 * This may be released temporarily in here. 11273 * @param pSnapshot If NULL, then the detachment is for the current machine. 11274 * Otherwise this is for a SnapshotMachine, and this must be 11275 * its snapshot. 11267 11276 * @return 11268 11277 */ … … 11337 11346 * will be passed on to i_detachDevice which needs it for temporary unlocking. 11338 11347 * 11339 * @param writeLock Machine lock from top-level caller; this gets passed to i_detachDevice. 11340 * @param pSnapshot Must be NULL when called for a "real" Machine or a snapshot object if called for a SnapshotMachine. 11341 * @param cleanupMode If DetachAllReturnHardDisksOnly, only hard disk media get added to llMedia; if 11342 * Full, then all media get added; 11343 * otherwise no media get added. 11344 * @param llMedia Caller's list to receive Medium objects which got detached so caller can close() them, depending on cleanupMode. 11348 * @param writeLock Machine lock from top-level caller; this gets passed to 11349 * i_detachDevice. 11350 * @param pSnapshot Must be NULL when called for a "real" Machine or a snapshot 11351 * object if called for a SnapshotMachine. 11352 * @param cleanupMode If DetachAllReturnHardDisksOnly, only hard disk media get 11353 * added to llMedia; if Full, then all media get added; 11354 * otherwise no media get added. 11355 * @param llMedia Caller's list to receive Medium objects which got detached so 11356 * caller can close() them, depending on cleanupMode. 11345 11357 * @return 11346 11358 */ -
trunk/src/VBox/Main/src-server/MediumAttachmentImpl.cpp
r65103 r65120 96 96 * @param aDevice Device number on the port. 97 97 * @param aType Device type. 98 * @param aImplicit 98 * @param aImplicit 99 99 * @param aPassthrough Whether accesses are directly passed to the host drive. 100 * @param aTempEject 100 * @param aTempEject Whether guest-triggered eject results in unmounting the medium. 101 101 * @param aNonRotational Whether this medium is non-rotational (aka SSD). 102 * @param aDiscard 102 * @param aDiscard Whether this medium supports discarding unused blocks. 103 103 * @param aHotPluggable Whether this medium is hot-pluggable. 104 * @param aBandwidthLimit Bandwidth limit in Mbps.104 * @param strBandwidthGroup Bandwidth group. 105 105 */ 106 106 HRESULT MediumAttachment::init(Machine *aParent, -
trunk/src/VBox/Main/src-server/MediumImpl.cpp
r65103 r65120 1441 1441 * @param aParent Parent medium disk or NULL for a root (base) medium. 1442 1442 * @param aDeviceType Device type of the medium. 1443 * @param uuidMachineRegistry The registry to which this medium should be added (global registry UUID or machine UUID). 1443 * @param uuidMachineRegistry The registry to which this medium should be added 1444 * (global registry UUID or machine UUID). 1444 1445 * @param data Configuration settings. 1445 * @param strMachineFolder The machine folder with which to resolve relative paths; if empty, then we use the VirtualBox home directory 1446 * @param strMachineFolder The machine folder with which to resolve relative 1447 * paths; if empty, then we use the VirtualBox home directory 1448 * @param mediaTreeLock Autolock. 1446 1449 * 1447 1450 * @note Locks the medium tree for writing. … … 5441 5444 * necessary consistency checks and place involved media to appropriate 5442 5445 * states. If #mergeTo() is not called or fails, the state modifications 5443 * performed by this method must be undone by # cancelMergeTo().5446 * performed by this method must be undone by #i_cancelMergeTo(). 5444 5447 * 5445 5448 * See #mergeTo() for more information about merging. … … 5451 5454 * @param fLockMedia Flag whether to lock the medium lock list or not. 5452 5455 * If set to false and the medium lock list locking fails 5453 * later you must call # cancelMergeTo().5456 * later you must call #i_cancelMergeTo(). 5454 5457 * @param fMergeForward Resulting merge direction (out). 5455 5458 * @param pParentForTarget New parent for target medium after merge (out). … … 5791 5794 * any VM directly or in the snapshot, otherwise this method will assert. 5792 5795 * 5793 * The # prepareMergeTo() method must be called prior to this method to place all5794 * involved to necessary states and perform other consistency checks.5796 * The #i_prepareMergeTo() method must be called prior to this method to place 5797 * all involved to necessary states and perform other consistency checks. 5795 5798 * 5796 5799 * If @a aWait is @c true then this method will perform the operation on the … … 5815 5818 * When this method fails (regardless of the @a aWait mode), it is a caller's 5816 5819 * responsibility to undo state changes and delete @a aMediumLockList using 5817 * # cancelMergeTo().5820 * #i_cancelMergeTo(). 5818 5821 * 5819 5822 * If @a aProgress is not NULL but the object it points to is @c null then a new … … 5923 5926 5924 5927 /** 5925 * Undoes what # prepareMergeTo() did. Must be called if #mergeTo() is not5928 * Undoes what #i_prepareMergeTo() did. Must be called if #mergeTo() is not 5926 5929 * called or fails. Frees memory occupied by @a aMediumLockList and unlocks 5927 5930 * the medium objects in @a aChildrenToReparent. … … 7530 7533 * @param pvUser The opaque data passed on container creation. 7531 7534 * @param rc The VBox error code. 7532 * @param RT_SRC_POS_DECLUse RT_SRC_POS.7535 * @param SRC_POS Use RT_SRC_POS. 7533 7536 * @param pszFormat Error message format string. 7534 7537 * @param va Error message arguments. -
trunk/src/VBox/Main/src-server/USBDeviceFilterImpl.cpp
r65103 r65120 859 859 * 860 860 * @param aParent Handle of the parent object. 861 * @param data Settings data. 861 862 */ 862 863 HRESULT HostUSBDeviceFilter::init(Host *aParent, … … 929 930 * 930 931 * @param aParent Handle of the parent object. 932 * @param aName Filter name. 931 933 */ 932 934 HRESULT HostUSBDeviceFilter::init(Host *aParent, IN_BSTR aName) … … 1247 1249 * @param aIdx The field index. 1248 1250 * @param aStr The new value. 1249 * @param aName The translated field name (for error messages).1250 1251 * 1251 1252 * @return COM status. -
trunk/src/VBox/Main/src-server/linux/HostHardwareLinux.cpp
r65088 r65120 893 893 virtual ~hotplugNullImpl (void) {} 894 894 /** @copydoc VBoxMainHotplugWaiter::Wait */ 895 virtual int Wait (RTMSINTERVAL) 896 { 895 virtual int Wait (RTMSINTERVAL cMillies) 896 { 897 NOREF(cMillies); 897 898 return VERR_NOT_SUPPORTED; 898 899 }
Note:
See TracChangeset
for help on using the changeset viewer.