Perintah WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION
Perintah WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION mengambil ID objek folder yang dapat menyimpan objek dari jenis tertentu. Perintah ini disediakan sebagai cara yang lebih cepat bagi klien untuk menemukan di mana perangkat menyimpan objek tertentu daripada dengan enumerasi objek brute.
Kategori perintah
WPD_CATEGORY_DEVICE_HINTS
Parameter
Driver mengharapkan parameter berikut.
Parameter | VarType | Deskripsi |
---|---|---|
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | Wajib diisi. Jenis objek yang ingin ditemukan oleh pemanggil kontainer. Misalnya, untuk menemukan folder tingkat atas yang digunakan untuk menyimpan gambar pada kamera digital, pemanggil akan mengirimkan WPD_CONTENT_TYPE_IMAGE. Lihat Persyaratan untuk Objek untuk daftar jenis objek yang ditentukan oleh Perangkat Portabel Windows. |
Tampilkan Nilai
Driver harus mengembalikan hasil berikut.
Hasil | VarType | Deskripsi |
---|---|---|
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | Wajib diisi. IPortableDevicePropVariantCollection jenis VT_LPWSTR nilai yang menentukan ID objek folder yang berisi objek jenis yang ditunjukkan oleh parameter panggilan. Jika tidak ada folder yang ditemukan, ini harus menjadi daftar kosong. Folder yang ditunjukkan oleh hasil mungkin atau mungkin tidak berisi objek dari tipe isi lainnya. Lihat properti WPD_FOLDER_CONTENT_TYPES_ALLOWED untuk informasi tentang pembatasan folder. |
WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Wajib diisi. HRESULT yang menunjukkan keberhasilan atau kegagalan menangani perintah. Jika pemanggil membuat permintaan yang tidak valid, driver harus mengembalikan HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) dan tidak diperlukan untuk mengembalikan nilai hasil lainnya. Kode kesalahan termasuk kode kesalahan Perangkat Portabel Windows atau kode kesalahan lain yang sesuai. |
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Opsional. Kode kesalahan khusus driver. Ini biasanya hanya digunakan untuk pengujian driver, atau jika driver, perangkat, dan klien semuanya dirancang bersama-sama. |
Metode Panggilan
Hanya dapat dipanggil langsung menggunakan IPortableDevice::SendCommand.
Persyaratan
Persyaratan | Nilai |
---|---|
Header |
|
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk