Comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION
El comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION recupera los identificadores de objeto de las carpetas que pueden contener un objeto de un tipo especificado. Este comando se proporciona como una manera más rápida de que un cliente detecte dónde un dispositivo almacena objetos específicos que la enumeración de objetos brutas.
Categoría de comando
WPD_CATEGORY_DEVICE_HINTS
Parámetros
El controlador espera los parámetros siguientes.
| Parámetro | VarType | Descripción |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | Obligatorio. Tipo de objeto para el que el autor de la llamada desea buscar el contenedor. Por ejemplo, para buscar las carpetas de nivel superior usadas para contener imágenes en una cámara digital, el autor de la llamada enviaría WPD_CONTENT_TYPE_IMAGE. Consulte Requisitos para objetos para obtener una lista de tipos de objetos definidos por Windows dispositivos portátiles. |
Valor devuelto
El controlador debe devolver los resultados siguientes.
| Resultado | VarType | Descripción |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | Obligatorio.
IPortableDevicePropVariantCollection de tipo VT_LPWSTR valores que especifican los identificadores de objeto de las carpetas que contienen objetos del tipo indicado por el parámetro de llamada. Si no se encuentra ninguna carpeta, debe ser una lista vacía. Las carpetas indicadas por el resultado pueden contener o no objetos de otros tipos de contenido. Consulte la propiedad WPD_FOLDER_CONTENT_TYPES_ALLOWED para obtener información sobre las restricciones de carpetas. |
| WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Obligatorio. HrESULT que indica que el comando se ha realizado correctamente o no. Si el autor de la llamada realiza una solicitud no válida, el controlador debe devolver HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) y no es necesario devolver ningún otro valor de resultado. Los códigos de error incluyen Windows códigos de error de dispositivos portátiles o cualquier otro código de error adecuado. |
| WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Opcional. Código de error específico del controlador. Normalmente, esto solo se usa para las pruebas de controladores o si el controlador, el dispositivo y el cliente están diseñados juntos. |
Llamar a métodos
Solo se puede llamar directamente mediante IPortableDevice::SendCommand.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|