Comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION
Il comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION recupera gli ID oggetto delle cartelle che possono contenere un oggetto di un tipo specificato. Questo comando viene fornito come modo più rapido per un client per individuare dove un dispositivo archivia oggetti specifici rispetto all'enumerazione degli oggetti bruti.
Categoria
WPD_CATEGORY_DEVICE_HINTS
Parametri
Per il driver sono previsti i parametri seguenti.
| Parametro | VarType | Descrizione |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | Obbligatorio. Tipo di oggetto per cui il chiamante desidera trovare il contenitore. Ad esempio, per trovare le cartelle di primo livello usate per contenere immagini su una fotocamera digitale, il chiamante invia WPD_CONTENT_TYPE_IMAGE. Vedere Requisiti per gli oggetti per un elenco dei tipi di oggetto definiti dai dispositivi portatili Windows. |
Valore restituito
Il driver dovrebbe restituire i risultati seguenti.
| Risultato | VarType | Descrizione |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | Obbligatorio.
Oggetto IPortableDevicePropVariantCollection di tipo VT_LPWSTR valori che specificano gli ID oggetto delle cartelle contenenti oggetti del tipo indicato dal parametro chiamante. Se non viene trovata alcuna cartella, dovrebbe essere un elenco vuoto. Le cartelle indicate dal risultato possono o non contenere oggetti di altri tipi di contenuto. Per informazioni sulle restrizioni delle cartelle, vedere la proprietà WPD_FOLDER_CONTENT_TYPES_ALLOWED . |
| WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Obbligatorio. HRESULT che indica l'esito positivo o negativo della gestione del comando. Se il chiamante effettua una richiesta non valida, il driver deve restituire HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) e non deve restituire altri valori di risultato. I codici di errore includono i codici di errore dei dispositivi portatili Windows o qualsiasi altro codice di errore appropriato. |
| WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Facoltativa. Codice di errore specifico del driver. Questa operazione viene in genere usata solo per i test dei driver o se il driver, il dispositivo e il client sono tutti progettati insieme. |
Chiamata di metodi
Può essere chiamato direttamente usando IPortableDevice::SendCommand.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|