Comando WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION

Artigo
06/12/2023

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	PortableDevice.h