IDeviceEmulatorManagerVMID
Aggiornamento: novembre 2007
L'interfaccia rappresenta un unico emulatore in Gestione emulatori di dispositivo (DEM). Utilizzare questa interfaccia per eseguire operazioni sull'emulatore, ad esempio connettere, inserire nell'alloggiamento e reimpostare.
interface IDeviceEmulatorManagerVMID : IDispatch{}
Metodi
Metodo |
Descrizione |
---|---|
Ottiene l'ID della macchina virtuale (VMID) che identifica in modo univoco l'emulatore. |
|
Ottiene lo stato corrente dell'emulatore. L'emulatore può essere in esecuzione, non in esecuzione o inserito nell'alloggiamento. |
|
Ottiene il nome dell'emulatore, ad esempio, Pocket PC 2003 SE - Emulatore. |
|
Avvia l'emulatore di dispositivo se non è già avviato e si connette ad esso. |
|
Inserisce l'emulatore nell'alloggiamento. |
|
Rimuove l'emulatore dall'alloggiamento. |
|
Spegne l'emulatore e, facoltativamente, ne salva lo stato. |
|
Esegue la reimpostazione dell'emulatore. |
|
Cancella il file di estensione dess associato a questo dispositivo. Al successivo avvio, l'emulatore verrà avviato dall'immagine ROM anziché dal file di stato salvato. |
|
Mostra la finestra Emulatore di dispositivi. |
|
Ottiene la configurazione dell'emulatore in formato XML decfg. |
|
Imposta la configurazione dell'emulatore data una stringa in formato XML decfg corretto. |
Note
Per creare un oggetto che implementa questa interfaccia, utilizzare IEnumVMIDs::get_VMID.
Esempio
In questo esempio viene avviato l'emulatore di Pocket PC 2003 e viene eseguita una varietà di operazioni.
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;
}
Requisiti
DEMComInterface.tlb