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

La méthode GetFunctionalCategories récupère toutes les catégories fonctionnelles prises en charge par l’appareil.

Syntaxe

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

Paramètres

[out] ppCategories

Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDevicePropVariantCollection qui contient toutes les catégories fonctionnelles de cet appareil. Les valeurs seront des GUIDde type VT_CLSID dans les valeurs PROPVARIANT récupérées. L’appelant doit libérer cette interface lorsqu’il a terminé avec elle.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

Les catégories fonctionnelles décrivent les types de fonctions qu’un appareil peut effectuer, telles que la capture d’images, la capture audio et le stockage. Cette méthode est généralement très rapide, car le pilote interroge généralement l’appareil uniquement au démarrage et met en cache les résultats.

Exemples

Pour obtenir un exemple d’utilisation de cette méthode, consultez Récupération des catégories fonctionnelles prises en charge par un appareil.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	portabledeviceapi.h
Bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

IPortableDeviceCapabilities, interface

Récupération des catégories fonctionnelles prises en charge par un appareil