IPortableDeviceCapabilities::GetFunctionalObjects-Methode (portabledeviceapi.h)
Die GetFunctionalObjects-Methode ruft alle funktionalen Objekte ab, die einer angegebenen Kategorie auf dem Gerät entsprechen.
Syntax
HRESULT GetFunctionalObjects(
[in] REFGUID Category,
[out] IPortableDevicePropVariantCollection **ppObjectIDs
);
Parameter
[in] Category
Eine REFGUID , die die kategorie angibt, nach der gesucht werden soll. Dies kann WPD_FUNCTIONAL_CATEGORY_ALL sein, um alle funktionalen Objekte zurückzugeben.
[out] ppObjectIDs
Adresse einer Variablen, die einen Zeiger auf eine IPortableDevicePropVariantCollection-Schnittstelle empfängt , die die Objekt-IDs der funktionalen Objekte als Zeichenfolgen enthält (Typ VT_LPWSTR in den abgerufenen PROPVARIANT-Elementen ). Wenn keine Objekte des angeforderten Typs gefunden werden, ist dies eine leere Auflistung (nicht NULL). 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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
Hinweise
Dieser Vorgang ist in der Regel schnell, da der Treiber keine vollständige Inhaltsaufzählung ausführen muss und die Anzahl der abgerufenen Funktionsobjekte in der Regel kleiner als 10 ist. Wenn keine Objekte des angeforderten Typs gefunden werden, gibt diese Methode keinen Fehler zurück, sondern eine leere Auflistung für ppObjectIDs.
Beispiele
Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen der Funktionsobjektbezeichner für ein Gerät.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |
Weitere Informationen
IPortableDeviceCapabilities-Schnittstelle
Abrufen der Funktionsobjektbezeichner für ein Gerät
Abrufen der von einem Gerät unterstützten Renderingfunktionen