Metodo IPortableDeviceCapabilities::GetFunctionalCategories (portabledeviceapi.h)

Il metodo GetFunctionalCategories recupera tutte le categorie funzionali supportate dal dispositivo.

Sintassi

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

Parametri

[out] ppCategories

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDevicePropVariantCollection che contiene tutte le categorie funzionali per questo dispositivo. I valori saranno GUIDdi tipo VT_CLSID nei valori PROPVARIANT recuperati. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Le categorie funzionali descrivono i tipi di funzioni che un dispositivo può eseguire, ad esempio l'acquisizione di immagini, l'acquisizione audio e l'archiviazione. Questo metodo è in genere molto veloce, perché il driver esegue in genere query sul dispositivo solo all'avvio e memorizza nella cache i risultati.

Esempio

Per un esempio di come usare questo metodo, vedere Recupero delle categorie funzionali supportate da un dispositivo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceCapabilities

Recupero delle categorie funzionali supportate da un dispositivo