WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION コマンド

WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION コマンドは、指定した種類のオブジェクトを保持できるフォルダーのオブジェクト ID を取得します。 このコマンドは、ブルート オブジェクト列挙よりもデバイスが特定のオブジェクトを格納する場所をクライアントが検出するための高速な方法として提供されます。

コマンドのカテゴリ

WPD_CATEGORY_DEVICE_HINTS

パラメーター

ドライバーは次のパラメーターを想定しています。

パラメーター	VarType	説明
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE	VT_CLSID	必須。 呼び出し元がコンテナーを検索するオブジェクトの種類。 たとえば、デジタル カメラで画像を保持するために使用される最上位のフォルダーを見つけるには、呼び出し元はWPD_CONTENT_TYPE_IMAGE送信します。 Windows ポータブル デバイスで定義されているオブジェクトの種類の一覧については、「オブジェクトの要件」を参照してください。

戻り値

ドライバーは次の結果を返す必要があります。

結果	VarType	説明
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS	VT_UNKNOWN	必須。 IPortableDevicePropVariantCollection 型VT_LPWSTR呼び出し元パラメーターによって示される型のオブジェクトを含むフォルダーのオブジェクト ID を指定する値です。 フォルダーが見つからない場合は、空のリストにする必要があります。結果によって示されるフォルダーには、他のコンテンツ タイプのオブジェクトが含まれている場合と含まれていない場合があります。 フォルダーの制限については、 WPD_FOLDER_CONTENT_TYPES_ALLOWED プロパティを参照してください。
WPD_PROPERTY_COMMON_HRESULT	VT_ERROR	必須。 コマンドの処理の成功または失敗を示す HRESULT 。 呼び出し元が無効な要求を行っている場合、ドライバーは HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) を返す必要があり、他の結果値を返す必要はありません。 エラー コードには、ポータブル デバイスWindowsエラー コードまたはその他の適切なエラー コードが含まれます。
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE	VT_UI4	任意。 ドライバー固有のエラー コード。 これは通常、ドライバーのテストにのみ使用されます。または、ドライバー、デバイス、およびクライアントがすべて一緒に設計されている場合に使用されます。

メソッドの呼び出し

IPortableDevice::SendCommand を使用してのみ直接呼び出すことができます。

必要条件

要件	値
ヘッダー	PortableDevice.h