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 Diperlukan atau Opsional
WPD_OBJECT_ID Diperlukan. Nilainya WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Diperlukan. Nilainya adalah string kosong.
WPD_OBJECT_NAME Diperlukan jika objek mewakili file.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Diperlukan.
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 Fakultatif.
WPD_OBJECT_SYNC_ID Fakultatif.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Fakultatif.
WPD_DEVICE_SYNC_PARTNER Fakultatif.
WPD_DEVICE_FIRMWARE_VERSION Diperlukan.
WPD_DEVICE_POWER_LEVEL Disarankan jika perangkat memiliki baterai.
WPD_DEVICE_POWER_SOURCE Direkomendasikan.
WPD_DEVICE_PROTOCOL Direkomendasikan.
WPD_DEVICE_MANUFACTURER Diperlukan.
WPD_DEVICE_MODEL Diperlukan.
WPD_DEVICE_SERIAL_NUMBER Diperlukan.
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 Fakultatif.
WPD_DEVICE_FRIENDLY_NAME Direkomendasikan.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Disarankan jika perangkat mendukung Manajemen Hak Digital (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Disarankan jika perangkat mendukung pengurutan format pilihan.
WPD_DEVICE_TYPE Direkomendasikan.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Fakultatif.
WPD_DEVICE_MODEL_UNIQUE_ID Fakultatif.
WPD_DEVICE_TRANSPORT Direkomendasikan.
WPD_DEVICE_USE_DEVICE_STAGE Fakultatif.
WPD_FUNCTIONAL_OBJECT_CATEGORY Diperlukan.

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 berada di bawah tiga kategori: semua perangkat, perangkat SMS, dan perangkat pengambilan 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 telepon seluler. 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