共用方式為


WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION命令

WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION命令會擷取資料夾的物件識別碼,這些資料夾可以保存指定型別的物件。 此命令會以更快速的方式提供,讓用戶端探索裝置儲存特定物件的位置,而不是暴力密碼物件列舉。

命令類別目錄

WPD_CATEGORY_DEVICE_HINTS

參數

驅動程式需要下列參數。

參數 VarType Description
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE VT_CLSID 必要。 呼叫端想要尋找容器的物件類型。 例如,若要尋找用來保存數位相機影像的最上層資料夾,呼叫端會提交WPD_CONTENT_TYPE_IMAGE。 如需 Windows 可攜式裝置所定義的物件類型清單,請參閱 物件需求

傳回值

驅動程式應該會傳回下列結果。

結果 VarType Description
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS VT_UNKNOWN 必要。 類型的 IPortableDevicePropVariantCollection VT_LPWSTR 值,指定資料夾的物件識別碼,其中包含呼叫參數所指示之型別的物件。 如果找不到資料夾,這應該是空的清單。結果所指示的資料夾可能或可能不會包含其他內容類型的物件。 如需資料夾限制的詳細資訊 ,請參閱 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