Metode IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)
Metode GetFunctionalObjects mengambil semua objek fungsional yang cocok dengan kategori tertentu pada perangkat.
Sintaks
HRESULT GetFunctionalObjects(
[in] REFGUID Category,
[out] IPortableDevicePropVariantCollection **ppObjectIDs
);
Parameter
[in] Category
REFGUID yang menentukan kategori yang akan dicari. Ini dapat WPD_FUNCTIONAL_CATEGORY_ALL untuk mengembalikan semua objek fungsional.
[out] ppObjectIDs
Alamat variabel yang menerima penunjuk ke antarmuka IPortableDevicePropVariantCollection yang berisi ID objek fungsional sebagai string (ketik VT_LPWSTR dalam item PROPVARIANT yang diambil). Jika tidak ada objek dari jenis yang diminta yang ditemukan, ini akan menjadi koleksi kosong (bukan NULL). Pemanggil harus merilis antarmuka ini ketika selesai dengannya.
Menampilkan nilai
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
Keterangan
Operasi ini biasanya cepat, karena driver tidak perlu melakukan enumerasi konten lengkap, dan jumlah objek fungsi yang diambil biasanya kurang dari 10. Jika tidak ada objek dari jenis yang diminta yang ditemukan, metode ini tidak akan mengembalikan kesalahan, tetapi mengembalikan koleksi kosong untuk ppObjectIDs.
Contoh
Untuk contoh cara menggunakan metode ini, lihat Mengambil Pengidentifikasi Objek Fungsi untuk Perangkat
Persyaratan
Target Platform | Windows |
Header | portabledeviceapi.h |
Pustaka | PortableDeviceGUIDs.lib |
Lihat juga
Antarmuka IPortableDeviceCapabilities