IPortableDeviceService::Metode SendCommand (portabledeviceapi.h)

Artikel
08/25/2023

Metode SendCommand mengirimkan perintah WPD standar dan parameternya ke layanan.

Sintaks

HRESULT SendCommand(
  [in]  const DWORD           dwFlags,
  [in]  IPortableDeviceValues *pParameters,
  [out] IPortableDeviceValues **ppResults
);

Parameter

[in] dwFlags

Tidak digunakan.

[in] pParameters

Antarmuka IPortableDeviceValues yang menentukan parameter perintah.

[out] ppResults

Antarmuka IPortableDeviceValues yang menentukan hasil perintah.

Menampilkan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Nilai HRESULT lainnya menunjukkan bahwa panggilan gagal.

Keterangan

Metode ini hanya boleh digunakan untuk mengirim perintah WPD standar ke layanan. Untuk memanggil metode layanan, gunakan antarmuka IPortableDeviceServiceMethods .

Metode ini mungkin gagal meskipun mengembalikan S_OK sebagai nilai HRESULT-nya . Untuk menentukan apakah perintah berhasil, aplikasi harus selalu memeriksa properti yang direferensikan oleh parameter ppResults :

Properti WPD_PROPERTY_COMMON_HRESULT menunjukkan apakah perintah berhasil.
Jika perintah gagal, properti WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE akan berisi kode kesalahan khusus driver.

Objek yang dirujuk oleh parameter pParameters harus menentukan setidaknya properti ini:

WPD_PROPERTY_COMMON_COMMAND_CATEGORY, yang harus berisi kategori perintah, seperti anggota fmtid properti WPD_COMMAND_COMMON_RESET_DEVICE
WPD_PROPERTY_COMMON_COMMAND_ID, yang harus berisi pengidentifikasi perintah, seperti anggota pid properti WPD_COMMAND_COMMON_RESET_DEVICE .

Persyaratan


Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	portabledeviceapi.h

Lihat juga

Antarmuka IPortableDeviceService

Bagikan melalui