Properti Perangkat (PortableDevice.h)
Perangkat Portabel Windows mendukung properti perangkat berikut ini.
| Properti | VarType | Deskripsi |
|---|---|---|
| WPD_DEVICE_DATETIME | VT_DATE | Tanggal dan waktu saat ini pada perangkat. |
| WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | Versi firmware perangkat. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Pengidentifikasi 16 byte unik yang umum di beberapa transportasi yang didukung oleh perangkat. Jika satu perangkat mendukung beberapa transportasi, properti ini dapat digunakan untuk mengaitkan berbagai driver WPD transportasi dengan perangkat tersebut. |
| WPD_DEVICE_MANUFACTURER | VT_LPWSTR | Nama produsen perangkat yang dapat dibaca manusia. |
| WPD_DEVICE_MODEL | VT_LPWSTR | Model perangkat. |
| WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Pengidentifikasi 16 byte unik yang digunakan untuk membedakan di antara berbagai model perangkat. |
| WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | Nilai yang menentukan pengidentifikasi jaringan EUI-64 perangkat; properti ini digunakan untuk operasi jaringan di luar band. Jika perangkat memiliki alamat jaringan fisik MAC-48 (khas jaringan IPv4), alamat MAC-48 dikodekan dalam alamat EUI-64 sebagai dua bagian alamat MAC-48 yang dipisahkan oleh FF-FF. Nilai EUI-64 disimpan dalam urutan "jaringan" atau "big-endian", di mana alamat UEI-64 01-02-03-FF-FF-04-05-06 akan ditempatkan di VT_UI8 sehingga nilai desimal 72624942021346566. Properti ini diperlukan pada perangkat apa pun yang mendukung Autentikasi Nominal atau Aman. Properti ini direkomendasikan pada perangkat yang hanya mendukung Autentikasi Nol. Nilai dapat digunakan oleh host untuk secara otomatis membuat akses ke perangkat tanpa intervensi pengguna. |
| WPD_DEVICE_POWER_LEVEL | VT_UI4 | Nilai dari 0 hingga 100 yang menentukan tingkat daya baterai perangkat, dengan 0 tidak ada, dan 100 diisi penuh. |
| WPD_DEVICE_POWER_SOURCE | VT_UI4 | Enumerasi WPD_POWER_SOURCES yang menentukan sumber daya perangkat. |
| WPD_DEVICE_PROTOCOL | VT_LPWSTR | Protokol perangkat yang sedang digunakan. |
| WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | Nomor seri perangkat. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | Nilai yang menentukan apakah format yang didukung yang dikembalikan dari perangkat berada dalam urutan yang disukai. Format pertama dalam daftar paling disukai oleh perangkat, sementara yang terakhir adalah yang paling tidak disukai. Aplikasi dapat menggunakan properti ini untuk menentukan apakah format perangkat yang didukung tercantum dalam urutan pilihan. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | Nilai Boolean yang menentukan apakah format yang didukung yang dikembalikan dari perangkat berada dalam urutan yang disukai; artinya, format pertama yang dikembalikan paling disukai sementara format terakhir yang dikembalikan paling tidak disukai. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | Nilai Boolean yang menentukan apakah perangkat mendukung objek yang tidak dapat dikonsumsi. Ini adalah objek yang hanya dimaksudkan untuk disimpan, tidak dimainkan, atau digunakan dengan cara apa pun. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Deskripsi yang dapat dibaca manusia dari mitra sinkronisasi perangkat. Ini adalah perangkat, aplikasi, atau server yang berkomunikasi dengan perangkat untuk mempertahankan status umum atau grup file antara kedua mitra. Contohnya termasuk program email dan pustaka musik. |
| WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | Nilai yang mewakili nama yang mudah diingat yang ditetapkan oleh pengguna di perangkat. |
| WPD_DEVICE_TRANSPORT | VT_UI4 | transportasi yang didukung oleh perangkat, seperti USB, IP, atau Bluetooth. Nilai yang valid adalah jenis enumerasi WPD_DEVICE_TRANSPORTS . |
| WPD_DEVICE_TYPE | VT_UI4 | Nilai yang menentukan jenis perangkat; aplikasi menggunakan properti ini hanya untuk tujuan representasi. Karakteristik fungsi dari perangkat diputuskan melalui objek fungsi. Perangkat yang tidak menyediakan ikon perangkat, misalnya, WPD_RESOURCE_ICON untuk objek perangkat, akan diwakili di Namespace Layanan WPD dengan ikon generik. Ikon ini akan bergantung pada jenis perangkat yang ditentukan, misalnya, jika jenis perangkat adalah ponsel, ikon telepon generik digunakan. Pada penginstalan pertama perangkat, Penginstal Kelas WPD akan mengkueri nilai properti ini dan menyimpannya di registri perangkat di bawah nilai PORTABLE_DEVICE_TYPE sebagai REG_DWORD. Nilai parameter ini mungkin berasal dari enumerasi WPD_DEVICE_TYPES yang ditentukan dalam PortableDevice.h. Nilainya adalah:
WPD_DEVICE_TYPE_CAMERA WPD_DEVICE_TYPE_MEDIA_PLAYER WPD_DEVICE_TYPE_PHONE WPD_DEVICE_TYPE_VIDEO WPD_DEVICE_TYPE_PERSONAL_INFORMATION_MANAGER WPD_DEVICE_TYPE_AUDIO_RECORDER |
| WPD_DEVICE_USE_DEVICE_STAGE | VT_BOOL | Jika properti ini ada dan diatur ke TRUE, perangkat dapat digunakan dengan Tahap Perangkat . Ini dimaksudkan untuk perangkat yang tidak dapat menyimpan metadata menggunakan Device Metadata Service, tetapi akan menyediakan metadata di server Microsoft. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk