コマンド (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 | 静止画像機能オブジェクトによって静止画像キャプチャを開始します。 |
関連トピック