IPortableDeviceCapabilities::GetFunctionalCategories-Methode (portabledeviceapi.h)

Die GetFunctionalCategories-Methode ruft alle funktionsbezogenen Kategorien ab, die vom Gerät unterstützt werden.

Syntax

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

Parameter

[out] ppCategories

Adresse einer Variablen, die einen Zeiger auf eine IPortableDevicePropVariantCollection-Schnittstelle empfängt, die alle Funktionskategorien für dieses Gerät enthält. Die Werte sind GUIDsvom Typ VT_CLSID in den abgerufenen PROPVARIANT-Werten . Der Aufrufer muss diese Schnittstelle freigeben, wenn sie damit fertig ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Funktionskategorien beschreiben die Funktionstypen, die ein Gerät ausführen kann, z. B. Bildaufnahme, Audioaufnahme und Speicher. Diese Methode ist in der Regel sehr schnell, da der Treiber das Gerät normalerweise nur beim Start abfragt und die Ergebnisse zwischenspeichert.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen der von einem Gerät unterstützten Funktionskategorien.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceCapabilities-Schnittstelle

Abrufen der von einem Gerät unterstützten Funktionskategorien