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

El método GetFunctionalCategories recupera todas las categorías funcionales compatibles con el dispositivo.

Sintaxis

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

Parámetros

[out] ppCategories

Dirección de una variable que recibe un puntero a una interfaz IPortableDevicePropVariantCollection que contiene todas las categorías funcionales de este dispositivo. Los valores serán GUIDde tipo VT_CLSID en los valores de PROPVARIANT recuperados. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

Las categorías funcionales describen los tipos de funciones que un dispositivo puede realizar, como la captura de imágenes, la captura de audio y el almacenamiento. Este método suele ser muy rápido, ya que el controlador normalmente consulta el dispositivo solo en el inicio y almacena en caché los resultados.

Ejemplos

Para obtener un ejemplo de cómo usar este método, consulte Recuperación de las categorías funcionales compatibles con un dispositivo.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceCapabilities (Interfaz)

Recuperar las categorías funcionales admitidas por un dispositivo