コマンド (WPD API)

  • [アーティクル]

クライアント アプリケーションとドライバーは、(Windows ポータブル デバイス API を介して) クライアントから (User-Mode Driver Framework 経由で) ドライバーに送信されるコマンドによって通信します。 コマンドにはパラメーターが含まれている場合と含まれていない場合があり、結果を返す場合と返されない場合があります。 クライアントは、IPortableDevice::SendCommand メソッドまたは IPortableDeviceService:SendCommand メソッドを呼び出すか、クライアント インターフェイスのいずれかのメソッドを呼び出すことによって暗黙的にコマンドを明示的に送信できます。 いくつかのコマンドは明示的にのみ送信できます。これらはコマンドのドキュメントに記載されています。 コマンド参照ページでは、コマンドの目的と、受け取る必要があるパラメーターと、返されるパラメーターについて説明します。

コマンドは PROPERTYKEY 構造体によって識別されます。 これは、GUID パーツ ( fmtid メンバー) と DWORD パーツ ( pid メンバー) の 2 つの部分で構成されます。 GUID 部分は、コマンドが属するカテゴリを示すために使用されます (関連コマンドは同じカテゴリに属しているため、同じ fmtid になります)。 DWORD 部分はコマンド ID を示し、コマンド カテゴリ内の個々のコマンドを区別するために使用されます (同じカテゴリ内のコマンドの pid 値は異なります)。

次の表に、Windows ポータブル デバイスで定義されるコマンドのカテゴリを示します。 デバイス製造元は、独自のコマンド カテゴリとコマンド ID を作成することで、独自のコマンドを定義できます。 ただし、製造元は以下のカテゴリにコマンドを追加しないでください。これらは Microsoft によって予約されているためです。

コマンド カテゴリ

コマンドのカテゴリ 説明
WPD_CATEGORY_COMMON すべてのオブジェクトとデバイスに共通のコマンド。
WPD_CATEGORY_DEVICE_HINTS エンド ユーザー エクスペリエンスを向上させるために使用できるオプションのデバイス情報を取得するために使用されるコマンド。
WPD_CATEGORY_SMS ショート メッセージ サービス (SMS) 機能をサポートするデバイスに使用されるコマンド。通常は携帯電話で公開されます。
WPD_CATEGORY_STILL_IMAGE_CAPTURE 静止画像キャプチャをサポートするデバイスに使用されるコマンド。
WPD_CATEGORY_STORAGE ストレージ機能オブジェクトに使用されるコマンド。

 

これらの各型に対して定義されている特定のコマンドは、コマンドの種類別に整理された次の表に示されています。

WPD_CATEGORY_COMMON カテゴリ

コマンド 説明
WPD_COMMAND_COMMON_RESET_DEVICE デバイスをリセットします。

 

WPD_CATEGORY_DEVICE_HINTS カテゴリ

コマンド 説明
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 指定した種類のオブジェクトを保持できるフォルダーのオブジェクト ID を取得します。

 

WPD_CATEGORY_STORAGE カテゴリ

コマンド 説明
WPD_COMMAND_STORAGE_EJECT ドライバーによってリモートで取り出すことができる記憶域メディアを取り出します。
WPD_COMMAND_STORAGE_FORMAT デバイス上のストレージ機能オブジェクトの書式を設定します。

 

WPD_CATEGORY_SMS カテゴリ

コマンド 説明
WPD_COMMAND_SMS_SEND SMS 機能オブジェクトによる SMS メッセージの送信を開始します。

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE カテゴリ

コマンド 説明
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE 静止画像機能オブジェクトによって静止画像キャプチャを開始します。

 

プログラミング リファレンス