IDeviceEmulatorManagerVMID

Essa interface representa um único emulador no DEM (dispositivo Emulator Manager).Use esta interface para executar operações, sistema autônomo se conectar, conectar e reiniciar, no emulador.

interface IDeviceEmulatorManagerVMID : IDispatch{}

Métodos

Método	Descrição
IDeviceEmulatorManagerVMID::get_VMID	Obtém o identificador de computador virtual (VMID) que identifica exclusivamente o emulador.
IDeviceEmulatorManagerVMID::get_State	Obtém o estado corrente do emulador.O emulador pode não executar, em execução ou conectado.
IDeviceEmulatorManagerVMID::get_Name	Obtém o nome do emulador, por exemplo, Pocket PC 2003 SE Emulator.
IDeviceEmulatorManagerVMID::conectar	Inicia o dispositivo Emulator se ele não ainda tenha sido iniciado e se conectar a ele.
IDeviceEmulatorManagerVMID::Cradle	Cradles o emulador.
IDeviceEmulatorManagerVMID::UnCradle	Uncradles o emulador.
IDeviceEmulatorManagerVMID::desligado	Desliga o emulador e, opcionalmente, salva o estado do emulador.
IDeviceEmulatorManagerVMID::reiniciar	Redefine o emulador.
IDeviceEmulatorManagerVMID::ClearSaveState	Limpa o Device Emulator salvar arquivo de estado (.dess) associado a este dispositivo.Na próxima vez que iniciar o, o emulador começará da sua imagem ROM em vez de seu arquivo de estado salvo.
IDeviceEmulatorManagerVMID::BringToFront	Mostra o Emulador de dispositivo janela.
IDeviceEmulatorManagerVMID::GetConfiguration	Obtém a configuração do emulador no formato XML de configuração do dispositivo Emulator.
IDeviceEmulatorManagerVMID::SetConfiguration	Define a configuração do emulador dada uma seqüência de caracteres do dispositivo Emulator configuração XML formatada corretamente.

Comentários

Para criar um objeto que implementa essa interface, use IEnumVMIDs::get_VMID.

Exemplo

Este exemplo inicia o emulador Pocket PC 2003 e executa uma variedade de operações.

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;
}

Requisitos

DEMComInterface.tlb

Consulte também

Outros recursos

Exemplos de emulador de dispositivo