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 |
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