Perintah (WPD API)

Aplikasi klien dan driver berkomunikasi melalui perintah yang dikirim dari klien (melalui WINDOWS Portable Device API) ke driver (melalui User-Mode Driver Framework). Perintah mungkin atau mungkin tidak menyertakan parameter, dan mungkin atau mungkin tidak mengembalikan hasil. Klien dapat mengirim perintah secara eksplisit, dengan memanggil metode IPortableDevice::SendCommand atau metode IPortableDeviceService:SendCommand , atau secara implisit, dengan memanggil salah satu metode antarmuka klien. Beberapa perintah hanya dapat dikirim secara eksplisit; ini dicatat dalam dokumentasi perintah. Halaman referensi perintah menjelaskan tujuan perintah, serta parameter apa yang diharapkan untuk diterima, dan parameter apa yang diharapkan untuk dikembalikan.

Perintah diidentifikasi oleh struktur PROPERTYKEY . Ini terdiri dari dua bagian: bagian GUID (anggota fmtid ) dan bagian DWORD (anggota pid ). Bagian GUID digunakan untuk menunjukkan kategori yang dimiliki perintah (perintah terkait termasuk dalam kategori yang sama, dan oleh karena itu akan memiliki fmtid yang sama). Bagian DWORD menunjukkan ID perintah, dan digunakan untuk membedakan perintah individual dalam kategori perintah (nilai pid untuk perintah dalam kategori yang sama akan berbeda).

Tabel berikut ini mencantumkan kategori perintah yang ditentukan Perangkat Portabel Windows. Produsen perangkat dapat menentukan perintah mereka sendiri dengan membuat kategori perintah dan ID perintah mereka sendiri. Namun, produsen tidak boleh menambahkan perintah ke kategori yang tercantum di bawah ini, karena perintah ini dicadangkan oleh Microsoft.

Kategori Perintah

Kategori perintah	Deskripsi
WPD_CATEGORY_COMMON	Perintah yang umum untuk semua objek dan perangkat.
WPD_CATEGORY_DEVICE_HINTS	Perintah yang digunakan untuk mengambil informasi perangkat opsional yang dapat digunakan untuk meningkatkan pengalaman pengguna akhir.
WPD_CATEGORY_SMS	Perintah yang digunakan untuk perangkat yang mendukung fungsionalitas layanan pesan singkat (SMS), yang biasanya diekspos di ponsel.
WPD_CATEGORY_STILL_IMAGE_CAPTURE	Perintah yang digunakan untuk perangkat yang mendukung pengambilan gambar diam.
WPD_CATEGORY_STORAGE	Perintah yang digunakan untuk objek fungsi penyimpanan.

 

Perintah tertentu yang ditentukan untuk masing-masing jenis ini diberikan dalam tabel berikut, diatur menurut jenis perintah.

Kategori WPD_CATEGORY_COMMON

Perintah	Deskripsi
WPD_COMMAND_COMMON_RESET_DEVICE	Mengatur ulang perangkat.

 

Kategori WPD_CATEGORY_DEVICE_HINTS

Perintah	Deskripsi
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION	Mengambil ID objek folder yang dapat menyimpan objek dari jenis tertentu.

 

Kategori WPD_CATEGORY_STORAGE

Perintah	Deskripsi
WPD_COMMAND_STORAGE_EJECT	Mengeluarkan media penyimpanan yang dapat dikeluarkan dari jarak jauh oleh driver.
WPD_COMMAND_STORAGE_FORMAT	Memformat objek fungsional penyimpanan pada perangkat.

 

Kategori WPD_CATEGORY_SMS

Perintah	Deskripsi
WPD_COMMAND_SMS_SEND	Memulai pengiriman pesan SMS oleh objek fungsional SMS.

 

Kategori WPD_CATEGORY_STILL_IMAGE_CAPTURE

Perintah	Deskripsi
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE	Memulai pengambilan gambar diam oleh objek fungsional gambar diam.

 

Topik terkait

Referensi Pemrograman