Método IPortableDeviceCapabilities::GetFunctionalCategories (portabledeviceapi.h)

O método GetFunctionalCategories recupera todas as categorias funcionais compatíveis com o dispositivo.

Sintaxe

HRESULT GetFunctionalCategories(
  [out] IPortableDevicePropVariantCollection **ppCategories
);

Parâmetros

[out] ppCategories

Endereço de uma variável que recebe um ponteiro para uma interface IPortableDevicePropVariantCollection que contém todas as categorias funcionais para este dispositivo. Os valores serão GUIDdo tipo VT_CLSID nos valores PROPVARIANT recuperados. O chamador deve liberar essa interface quando terminar com ela.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Categorias funcionais descrevem os tipos de funções que um dispositivo pode executar, como captura de imagem, captura de áudio e armazenamento. Esse método normalmente é muito rápido, pois o driver geralmente consulta o dispositivo somente na inicialização e armazena em cache os resultados.

Exemplos

Para obter um exemplo de como usar esse método, consulte Recuperando as categorias funcionais compatíveis com um dispositivo.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceCapabilities Interface

Recuperando as categorias funcionais compatíveis com um dispositivo