commande WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION
La commande WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION récupère les ID d’objet des dossiers qui peuvent contenir un objet d’un type spécifié. Cette commande est fournie comme un moyen plus rapide pour un client de découvrir où un appareil stocke des objets spécifiques que par énumération d’objets bruts.
Catégorie de commande
WPD_CATEGORY_DEVICE_HINTS
Paramètres
Le pilote attend les paramètres suivants :
| Paramètre | VarType | Description |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | Obligatoire. Type d’objet pour lequel l’appelant souhaite trouver le conteneur. Par exemple, pour rechercher les dossiers de niveau supérieur utilisés pour contenir des images sur un appareil photo numérique, l’appelant envoie WPD_CONTENT_TYPE_IMAGE. Consultez Configuration requise pour les objets pour obtenir la liste des types d’objets définis par les appareils portables Windows. |
Valeur renvoyée
Le pilote doit renvoyer les résultats suivants.
| Résultats | VarType | Description |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | Obligatoire. Un IPortableDevicePropVariantCollection de type VT_LPWSTR des valeurs qui spécifient les ID d’objet des dossiers contenant des objets du type indiqué par le paramètre appelant. Si aucun dossier n’est trouvé, il doit s’agir d’une liste vide. Les dossiers indiqués par le résultat peuvent contenir ou non des objets d’autres types de contenu. Pour plus d’informations sur les restrictions de dossier, consultez la propriété WPD_FOLDER_CONTENT_TYPES_ALLOWED . |
| WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Obligatoire. HRESULT qui indique la réussite ou l’échec de la gestion de la commande. Si l’appelant effectue une requête non valide, le pilote doit retourner HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) et n’est pas tenu de retourner d’autres valeurs de résultat. Les codes d’erreur incluent les codes d’erreur des appareils portables Windows ou tout autre code d’erreur approprié. |
| WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Optionnel. Code d’erreur spécifique au pilote. Cela est généralement utilisé uniquement pour les tests de pilote, ou si le pilote, l’appareil et le client sont tous conçus ensemble. |
Appel de méthodes
Peut uniquement être appelé directement à l’aide de IPortableDevice::SendCommand.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|