Bagikan melalui

Objek Perangkat

  • Artikel

Objek perangkat mendukung properti berikut. Aplikasi dapat meminta properti ini dengan mengkueri objek akar (menentukan ID objek konstanta WPD_DEVICE_OBJECT_ID yang ditentukan). Semua nilai objek perangkat bersifat baca-saja.

Jika perangkat tertentu mengimplementasikan kategori WPD_FUNCTIONAL_CATEGORY_DEVICE , perangkat tersebut juga harus mendukung properti yang terkait dengan kategori tersebut.

Nama Properti Wajib atau Opsional
WPD_OBJECT_ID Wajib diisi. Nilainya WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Wajib diisi. Nilainya adalah string kosong.
WPD_OBJECT_NAME Diperlukan jika objek mewakili file.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Wajib diisi.
WPD_OBJECT_ISHIDDEN Diperlukan jika objek perangkat tidak boleh ditampilkan kepada pengguna.
WPD_OBJECT_REFERENCES Diperlukan jika objek perangkat memiliki referensi ke objek lain.
WPD_OBJECT_KEYWORDS Pilihan.
WPD_OBJECT_SYNC_ID Opsional.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Opsional.
WPD_DEVICE_SYNC_PARTNER Pilihan.
WPD_DEVICE_FIRMWARE_VERSION Wajib diisi.
WPD_DEVICE_POWER_LEVEL Disarankan jika perangkat memiliki baterai.
WPD_DEVICE_POWER_SOURCE Disarankan.
WPD_DEVICE_PROTOCOL Disarankan.
WPD_DEVICE_MANUFACTURER Wajib diisi.
WPD_DEVICE_MODEL Wajib diisi.
WPD_DEVICE_SERIAL_NUMBER Wajib diisi.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE Diperlukan jika perangkat mendukung objek yang tidak dapat dikonsumsi; artinya, jika dapat digunakan untuk penyimpanan data sederhana.
WPD_DEVICE_DATETIME Pilihan.
WPD_DEVICE_FRIENDLY_NAME Disarankan.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Disarankan jika perangkat mendukung Manajemen Hak Digital (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Disarankan jika perangkat mendukung pemesanan format pilihan.
WPD_DEVICE_TYPE Disarankan.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Pilihan.
WPD_DEVICE_MODEL_UNIQUE_ID Opsional.
WPD_DEVICE_TRANSPORT Disarankan.
WPD_DEVICE_USE_DEVICE_STAGE Pilihan.
WPD_FUNCTIONAL_OBJECT_CATEGORY Wajib diisi.

Sumber Daya Umum

Objek ini biasanya tidak menghosting sumber daya.

Perintah

Selain properti, perangkat harus mendukung serangkaian perintah tertentu yang ditentukan oleh Perangkat Portabel Windows. Perintah apa yang didukung objek atau perangkat tergantung pada jenis, fungsionalitas, dan kemampuannya.

Tabel berikut ini menjelaskan kelas perintah yang berlaku untuk perangkat, berdasarkan fungsionalitas. Biasanya, perangkat termasuk dalam beberapa kategori, dan harus mendukung perintah untuk semua kategori yang berlaku. Misalnya, ponsel dengan kamera akan termasuk dalam tiga kategori: semua perangkat, perangkat SMS, dan perangkat penangkapan gambar diam. Driver kustom dan aplikasi klien dapat mendukung perintah atau properti tambahan yang Anda tentukan, tetapi harus mendukung perintah berikut. Untuk deskripsi perintah tertentu yang termasuk dalam setiap kategori perintah, lihat Perintah.

Deskripsi Kategori perintah
Semua perangkat. WPD_CATEGORY_CAPABILITIESWPD_CATEGORY_COMMON
WPD_CATEGORY_OBJECT_ENUMERATION
WPD_CATEGORY_OBJECT_MANAGEMENT
WPD_CATEGORY_OBJECT_PROPERTIES
WPD_CATEGORY_OBJECT_PROPERTIES_BULK
WPD_CATEGORY_OBJECT_RESOURCES
Perangkat yang dapat mengambil gambar diam, seperti kamera digital. WPD_CATEGORY_STILL_IMAGE_CAPTURE
Perangkat yang dapat mengirim pesan layanan pesan singkat (SMS), seperti ponsel. Mengirim pesan SMS sering disebut "pesan teks". WPD_CATEGORY_SMS
Perangkat yang berfungsi sebagai perangkat penyimpanan. Ini termasuk drive eksternal. Jika perangkat mendukung kemampuan untuk memformat penyimpanan atau memindahkan objek dari satu lokasi ke lokasi lain, driver Anda harus mendukung kategori ini.
 WPD_CATEGORY_STORAGE

Persyaratan untuk Objek