IPortableDeviceManager::GetDevices method (portabledeviceapi.h)
Mengambil daftar perangkat portabel yang tersambung ke komputer.
Sintaks
HRESULT GetDevices(
[in, out] LPWSTR *pPnPDeviceIDs,
[in, out] DWORD *pcPnPDeviceIDs
);
Parameter
[in, out] pPnPDeviceIDs
Array penunjuk string yang dialokasikan penelepon yang menyimpan nama Plug and Play dari semua perangkat yang terhubung. Untuk mempelajari ukuran yang diperlukan untuk parameter ini, pertama-tama panggil metode ini dengan parameter ini diatur ke NULL dan pcPnPDeviceID diatur ke nol, lalu alokasikan buffer sesuai dengan nilai yang diambil oleh pcPnPDeviceIDs. Nama-nama ini dapat digunakan oleh IPortableDevice::Open untuk membuat koneksi ke perangkat.
[in, out] pcPnPDeviceIDs
Pada input, jumlah nilai yang dapat dipegang oleh pPnPDeviceIDs . Pada output, pointer ke jumlah perangkat yang benar-benar ditulis ke pPnPDeviceIDs.
Nilai kembali
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Setidaknya salah satu argumen yang diperlukan adalah penunjuk NULL . |
|
Buffer pPnPDeviceIDs terlalu kecil untuk menahan semua nilai yang diminta, tetapi nilai pcPnPDeviceIDs telah ditulis ke pPnPDeviceIDs. |
Keterangan
Daftar perangkat dihasilkan ketika manajer perangkat dibuat; tidak disegarkan saat perangkat tersambung dan terputus. Untuk merefresh daftar perangkat yang tersambung, panggil RefreshDeviceList.
API mengalokasikan memori untuk setiap string yang diarahkan oleh array pPnPDeviceIDs . Setelah aplikasi Anda tidak lagi membutuhkan string ini, aplikasi harus melakukan iterasi melalui array ini dan membebaskan memori terkait dengan memanggil fungsi CoTaskMemFree .
Contoh
Untuk contoh cara menggunakan metode ini untuk menghitung perangkat, lihat Menghitung Perangkat. Untuk contoh cara menggunakan metode ini untuk menghitung Layanan, lihat Menghitung Layanan.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | portabledeviceapi.h |
Pustaka | PortableDeviceGUIDs.lib |