IDeviceEmulatorManagerVMID

Обновлен: Ноябрь 2007

Этот интерфейс представляет отдельный эмулятор в диспетчере эмуляторов устройств. Используйте этот интерфейс для выполнения действий с эмулятором, таких как подключение, помещение в гнездо и сброс.

interface IDeviceEmulatorManagerVMID : IDispatch{}

Методы

Метод	Описание
IDeviceEmulatorManagerVMID::get_VMID	Получает идентификатор виртуального компьютера (VMID), который уникально идентифицирует эмулятор.
IDeviceEmulatorManagerVMID::get_State	Получает текущее состояние эмулятора. Эмулятор может работать, не работать или находится в гнезде.
IDeviceEmulatorManagerVMID::get_Name	Получает имя эмулятора, например Pocket PC 2003 SE Emulator.
IDeviceEmulatorManagerVMID::Connect	Запускает эмулятор устройства, если он еще не запущен, затем подключается к нему.
IDeviceEmulatorManagerVMID::Cradle	Помещает эмулятор в гнездо.
IDeviceEmulatorManagerVMID::UnCradle	Убирает эмулятор из гнезда.
IDeviceEmulatorManagerVMID::Shutdown	Завершает работу эмулятора и, если необходимо, сохраняет состояние эмулятора.
IDeviceEmulatorManagerVMID::Reset	Выполняет сброс эмулятора.
IDeviceEmulatorManagerVMID::ClearSaveState	Очищает файл сохраненного состояния эмулятора устройства (DESS), связанный с этим эмулятором. При следующем запуске эмулятор загрузится из образа ПЗУ, а не из файла сохраненного состояния.
IDeviceEmulatorManagerVMID::BringToFront	Отображает окно Эмулятор устройства.
IDeviceEmulatorManagerVMID::GetConfiguration	Получает конфигурацию эмулятора в XML-формате конфигурации эмулятора устройства.
IDeviceEmulatorManagerVMID::SetConfiguration	Задает конфигурацию эмулятора при наличии правильно отформатированной XML-строки конфигурации эмулятора устройства.

Заметки

Для создания объекта, реализующего данный интерфейс, используется метод IEnumVMIDs::get_VMID.

Пример

В этом примере запускается эмулятор Pocket PC 2003 и выполняются различные операции.

BOOL FindDevice(const CComBSTR& deviceIdentifier, IDeviceEmulatorManagerVMID** pDeviceVMID);

int _tmain(int argc, _TCHAR* argv[])
{
    if (SUCCEEDED(CoInitializeEx(NULL, COINIT_MULTITHREADED)))
    {
        HRESULT hr;
        CComPtr<IDeviceEmulatorManagerVMID> pDevice = NULL;

        // Get the emulator by calling a helper function
        hr = FindDevice("Pocket PC 2003 SE Emulator", &pDevice);

        // If the emulator is found
        if (SUCCEEDED(hr))
        {
            // Output the name of the emulator
            CComBSTR deviceName;
            hr = pDevice->get_Name(&deviceName);
            if (SUCCEEDED(hr)) wprintf_s(L"Device Name: %s\n", deviceName);

            // Output the emulator's VMID
            CComBSTR VMID;
            hr = pDevice->get_VMID(&VMID);
            if (SUCCEEDED(hr)) wprintf_s(L"Device VMID: %s\n", VMID);

            // Output the emulator's current state
            EMULATOR_STATE deviceState = EMU_NOT_RUNNING;
            hr = pDevice->get_State(&deviceState);
            if (SUCCEEDED(hr))
            {
                if (deviceState == EMU_CRADLED) wprintf_s(L"Emulator is Cradled\n");
                else if (deviceState == EMU_RUNNING) wprintf_s(L"Emulator is Running\n");
                else wprintf_s(L"Emulator is Not Running\n");
            }

            // Connect to the emulator
            hr = pDevice->Connect();
            if (SUCCEEDED(hr)) wprintf_s(L"Emulator is connected\n");

            // Make the Device Emulator window visible
            hr = pDevice->BringToFront();
            if (SUCCEEDED(hr)) wprintf_s(L"Device Emulator window is on top\n");

            // Cradle the emulator
            hr = pDevice->Cradle();
            if (SUCCEEDED(hr)) wprintf_s(L"Emulator is cradled\n");
            system("pause");

            // Uncradle the emulator
            hr = pDevice->UnCradle();
            if (SUCCEEDED(hr)) wprintf_s(L"Emulator is uncradled\n");

            // Save state and shutdown the emulator
            hr = pDevice->Shutdown(true);
            if (SUCCEEDED(hr)) wprintf_s(L"Emulator is shutdown\n");

            // Delete the .dess save state file for this device
            hr = pDevice->ClearSaveState();
            if (SUCCEEDED(hr)) wprintf_s(L"Save state file is deleted");
            system("pause");
        }
    }
    return 0;
}

// Helper method to find a device given name or VMID
BOOL FindDevice(const CComBSTR& deviceIdentifier, IDeviceEmulatorManagerVMID** pDeviceVMID)
{
    HRESULT hr;

    // Instantiate DeviceEmulatorManager (DEM) object.
    //  This starts DvcEmuManager.exe in silent mode
    CComPtr<IDeviceEmulatorManager> pDeviceEmulatorManager;
    hr = pDeviceEmulatorManager.CoCreateInstance(__uuidof(DeviceEmulatorManager));
    if (FAILED(hr)) {
        wprintf_s(L"Error: Unable to instantiate DeviceEmulatorManager. ErrorCode=0x%08X\n", hr);
        return FALSE;
    }

    // For each of the four nodes in the Device Emulator Manager window
    // (Datastore, My Device Emulators, All Device Emulators, and Others)
    for (; SUCCEEDED(hr); (hr = pDeviceEmulatorManager->MoveNext()))
    {
        CComPtr<IEnumManagerSDKs> pSDKEnumerator;


        // Get a list of SDKs/platforms in this node
        hr = pDeviceEmulatorManager->EnumerateSDKs(&pSDKEnumerator);
        if (FAILED(hr)) {
            continue;
        }

        // For every SDK/platform in the list
        for (; SUCCEEDED(hr); (hr = pSDKEnumerator->MoveNext()))
        {

            // Get the list of emulators in the SDK/platform
            CComPtr<IEnumVMIDs> pDeviceEnumerator;
            hr = pSDKEnumerator->EnumerateVMIDs(&pDeviceEnumerator);
            if (FAILED(hr)) {
                continue;
            }

            // For every emulator in the list
            for (; SUCCEEDED(hr); (hr = pDeviceEnumerator->MoveNext()))
            {
                CComBSTR deviceName;
                CComPtr<IDeviceEmulatorManagerVMID> pDevice;

                // Get the IDeviceEmulatorManagerVMID object.
                hr = pDeviceEnumerator->GetVMID(&pDevice);
                if (FAILED(hr)) {
                    continue;
                }

                // Get the name of the emulator
                hr = pDevice->get_Name(&deviceName);
                if (FAILED(hr)){
                    continue;
                }

                // If the name of the device matches the supplied name, 
                // then this is the device we are looking for. 
                if (deviceIdentifier == deviceName){
                    *pDeviceVMID = pDevice;
                    (*pDeviceVMID)->AddRef();
                    return TRUE;
                }
            }
        }
    }
    wprintf_s(L"Error: Unable to locate the device '%s'", deviceIdentifier);
    return FALSE;
}

Требования

DEMComInterface.tlb

См. также

Другие ресурсы

Примеры эмуляторов устройств