Metode IPortableDeviceCapabilities::GetCommandOptions (portabledeviceapi.h)

  • Artikel

Metode GetCommandOptions mengambil semua opsi yang didukung untuk perintah yang ditentukan pada perangkat.

Sintaks

HRESULT GetCommandOptions(
  [in]  REFPROPERTYKEY        Command,
  [out] IPortableDeviceValues **ppOptions
);

Parameter

[in] Command

REFPROPERTYKEY yang menentukan perintah untuk mengkueri opsi yang didukung. Untuk daftar perintah yang ditentukan oleh Perangkat Portabel Windows, lihat Perintah.

[out] ppOptions

Alamat variabel yang menerima pointer ke antarmuka IPortableDeviceValues yang berisi opsi yang didukung. Jika tidak ada opsi yang didukung, ini tidak akan berisi nilai apa pun. Pemanggil harus merilis antarmuka ini ketika selesai. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.

Keterangan

Metode ini dipanggil oleh aplikasi yang ingin memanggil perintah langsung pada driver dengan memanggil IPortableDevice::SendCommand. Beberapa perintah memungkinkan pemanggil menentukan opsi tambahan. Misalnya, beberapa driver mendukung penghapusan anak rekursif saat menghapus objek menggunakan perintah WPD_COMMAND_OBJECT_MANAGEMENT_DELETE_OBJECTS.

Jika opsi adalah nilai Boolean sederhana, kunci antarmuka IPortableDeviceValues yang diambil akan menjadi nama opsi, dan nilai PROPVARIANT akan menjadi nilai VT_BOOL True atau False. Jika opsi memiliki beberapa nilai, nilai PROPVARIANT yang diambil akan menjadi jenis koleksi yang menyimpan nilai yang didukung.

Jika metode ini dipanggil untuk perintah WPD_COMMAND_STORAGE_FORMAT dan parameter ppOptions diatur ke WPD_OPTION_VALID_OBJECT_IDS, driver akan mengembalikan kumpulan jenis IPortableDevicePropVariant VT_LPWSTR yang menentukan pengidentifikasi untuk setiap objek pada perangkat yang dapat diformat. (Jika opsi ini tidak ada, perintah format tersedia untuk semua objek.)

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header portabledeviceapi.h
Pustaka PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceCapabilities