Perintah WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION

  • Artikel

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
PortableDevice.h