Metode IPortableDeviceWebControl::GetDeviceFromId (portabledeviceapi.h)
Membuat instans objek Perangkat Automasi WPD untuk pengidentifikasi perangkat WPD tertentu.
Sintaks
HRESULT GetDeviceFromId(
[in] BSTR deviceId,
[out, retval] IDispatch **ppDevice
);
Parameter
[in] deviceId
BSTR yang digunakan oleh Plug-and-play untuk mengidentifikasi perangkat WPD yang saat ini terhubung. Pengidentifikasi Plug and Play (PnP) untuk perangkat tertentu dapat diperoleh dari metode IPortableDeviceManager::GetDevices di API WPD C++/COM.
Aplikasi Windows Store dapat memperoleh pengidentifikasi PnP perangkat WPD dengan menggunakan Windows.Devices.Portable.ServiceDevice.GetDeviceSelector atau Windows.Devices.Portable.ServiceDevice.GetDeviceSelectorFromServiceId untuk mendapatkan string pemilih untuk diteruskan ke Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. FindAllAsync mengembalikan kumpulan objek DeviceInformation yang mewakili perangkat WPD yang saat ini terhubung. Properti Id objek DeviceInformation adalah pengidentifikasi PnP perangkat.
[out, retval] ppDevice
Berisi penunjuk ke implementasi IDispatch untuk objek Perangkat Automasi WPD.
Nilai kembali
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Panggilan ke metode ini di luar aplikasi Windows Store yang berjalan di Windows 8 akan mengembalikan kode galat ini. |
Keterangan
Contoh
Untuk perangkat WPD yang menggunakan layanan perangkat MTP, Anda dapat membuat objek COM Automation untuk bekerja dengan perangkat seperti ini:
deviceFactory = new ActiveXObject("PortableDeviceAutomation.Factory");
var device = deviceFactory.getDeviceFromId(deviceId);
// Get the first service on the device
var deviceService = device.services[0];
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8 [hanya aplikasi UWP] |
Server minimum yang didukung | Windows Server 2012 [hanya aplikasi UWP] |
Target Platform | Windows |
Header | portabledeviceapi.h |