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.

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)

Weitere Informationen

IPortableDeviceCapabilities-Schnittstelle

Abrufen der Funktionsobjektbezeichner für ein Gerät

Abrufen der von einem Gerät unterstützten Renderingfunktionen