Comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION
O comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION recupera as IDs de objeto de pastas que podem conter um objeto de um tipo especificado. Esse comando é fornecido como uma maneira mais rápida de um cliente descobrir onde um dispositivo armazena objetos específicos do que por enumeração de objeto bruto.
Categoria de comando
WPD_CATEGORY_DEVICE_HINTS
Parâmetros
O driver espera os parâmetros a seguir.
| Parâmetro | VarType | Descrição |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | Obrigatórios. O tipo de objeto para o qual o chamador deseja localizar o contêiner. Por exemplo, para localizar as pastas de nível superior usadas para armazenar imagens em uma câmera digital, o chamador enviaria WPD_CONTENT_TYPE_IMAGE. Consulte Requisitos para objetos para obter uma lista de tipos de objeto definidos por Dispositivos Portáteis do Windows. |
Valor Retornado
O driver deve retornar os resultados a seguir.
| Result | VarType | Descrição |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | Obrigatórios. Um IPortableDevicePropVariantCollection do tipo VT_LPWSTR valores que especificam as IDs de objeto de pastas que contêm objetos do tipo indicados pelo parâmetro de chamada. Se nenhuma pasta for encontrada, essa deverá ser uma lista vazia. As pastas indicadas pelo resultado podem ou não conter objetos de outros tipos de conteúdo. Consulte a propriedade WPD_FOLDER_CONTENT_TYPES_ALLOWED para obter informações sobre restrições de pasta. |
| WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Obrigatórios. Um HRESULT que indica êxito ou falha ao manipular o comando. Se o chamador estiver fazendo uma solicitação inválida, o driver deverá retornar HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) e não será necessário retornar nenhum outro valor de resultado. Os códigos de erro incluem códigos de erro de Dispositivos Portáteis do Windows ou outros códigos de erro apropriados. |
| WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Opcional. Um código de erro específico do driver. Normalmente, isso é usado apenas para testes de driver ou se o driver, o dispositivo e o cliente são projetados juntos. |
Chamando métodos
Só pode ser chamado diretamente usando IPortableDevice::SendCommand.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|