Bagikan melalui

Perintah (WPD API)

  • Artikel

Aplikasi klien dan driver berkomunikasi dengan 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 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 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 pada 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 fungsi.

 

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 Mereset 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.

 

WPD_CATEGORY_STORAGE Kategori

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.

 

Referensi Pemrograman