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 呼叫。
規格需求
需求 | 值 |
---|---|
標頭 |
|