IPortableDeviceService::SendCommand メソッド (portabledeviceapi.h)

SendCommand メソッドは、標準の WPD コマンドとそのパラメーターをサービスに送信します。

構文

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

パラメーター

[in] dwFlags

使用しません。

[in] pParameters

コマンド パラメーターを指定する IPortableDeviceValues インターフェイス。

[out] ppResults

コマンドの結果を指定する IPortableDeviceValues インターフェイス。

戻り値

メソッドが成功すると、 S_OKが返されます。 その他の HRESULT 値は、呼び出しが失敗したことを示します。

解説

このメソッドは、標準の WPD コマンドをサービスに送信する場合にのみ使用する必要があります。 サービス メソッドを呼び出すには、 IPortableDeviceServiceMethods インターフェイスを 使用します。

このメソッドは、HRESULT 値としてS_OKを返しても失敗する可能性があります。 コマンドが成功したかどうかを判断するには、アプリケーションで 常に ppResults パラメーターによって参照されるプロパティを調べる必要があります。

• WPD_PROPERTY_COMMON_HRESULT プロパティは、コマンドが成功したかどうかを示します。
• コマンドが失敗した場合、 WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE プロパティにはドライバー固有のエラー コードが含まれます。

• WPD_PROPERTY_COMMON_COMMAND_CATEGORY。コマンド カテゴリ (WPD_COMMAND_COMMON_RESET_DEVICE プロパティの fmtid メンバーなど) を含める必要があります
• WPD_PROPERTY_COMMON_COMMAND_ID。コマンド識別子 (WPD_COMMAND_COMMON_RESET_DEVICE プロパティの pid メンバーなど) を含める必要があります。

要件

関連項目

IPortableDeviceService インターフェイス