次の方法で共有

コマンド (WPD API)

  • [アーティクル]

クライアント アプリケーションとドライバーは、(Windows ポータブル デバイス API を介して) クライアントから (User-Mode ドライバー フレームワーク経由で) ドライバーに送信されるコマンドによって通信します。 コマンドにはパラメーターが含まれている場合と含まれていない場合があり、結果が返される場合と返されない場合があります。 クライアントは、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 静止画像機能オブジェクトによる静止画像キャプチャを開始します。

 

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