IPortableDevicePropertiesBulk::QueueGetValuesByObjectFormat-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die QueueGetValuesByObjectFormat-Schnittstelle stellt eine Anforderung für Eigenschaften von Objekten eines bestimmten Formats auf einem Gerät in die Warteschlange.

Syntax

HRESULT QueueGetValuesByObjectFormat(
  [in]  REFGUID                               pguidObjectFormat,
  [in]  LPCWSTR                               pszParentObjectID,
  [in]  const DWORD                           dwDepth,
  [in]  IPortableDeviceKeyCollection          *pKeys,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);

Parameter

[in] pguidObjectFormat

Zeiger auf eine GUID , die das Objektformat angibt. Es werden nur Objekte dieses Typs abgefragt.

[in] pszParentObjectID

Zeiger auf eine NULL-endende Zeichenfolge, die die Objekt-ID des übergeordneten Objekts enthält, in dem die Suche beginnen soll. Um alle Objekte auf einem Gerät zu durchsuchen, geben Sie WPD_DEVICE_OBJECT_ID an.

[in] dwDepth

Die maximale Tiefe, die unterhalb des übergeordneten Elements gesucht werden soll, wobei 1 nur unmittelbar untergeordnete Elemente bedeutet. Es ist akzeptabel, dass diese Zahl größer als die tatsächliche Anzahl von Ebenen ist. Geben Sie 0xFFFFFFFF an, um eine beliebige Tiefe zu suchen.

[in] pKeys

Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die die abzurufenden Eigenschaften enthält. Eine Liste der Eigenschaften, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Eigenschaften und Attribute. Geben Sie NULL an, um alle Eigenschaften aus dem angegebenen Format anzugeben.

[in] pCallback

Zeiger auf eine von der Anwendung implementierte IPortableDevicePropertiesBulkCallback-Schnittstelle , die die Informationen beim Abrufen empfängt.

[out] pContext

Zeiger auf eine GUID, die zum Starten, Abbrechen oder Identifizieren der Anforderung in IPortableDevicePropertiesBulkCallback-Rückrufen verwendet wird, sofern implementiert.

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	Der Vorgang wurde erfolgreich in die Warteschlange gestellt.

Hinweise

Wenn Sie WPD_OBJECT_FORMAT_ALL für den pguidObjectFormat-Parameter angeben, gibt diese Methode Eigenschaften für alle Objekte auf dem Gerät zurück.

Wenn der Parameter pszParentObjectID auf eine leere Zeichenfolge ("") festgelegt ist, führt die Methode eine Suche durch, die vom dwDepth-Parameter abhängig ist, wie in der folgenden Tabelle beschrieben.

dwDepth	Die Methode gibt zurück
0	Keine Ergebnisse.
1	Werte nur für das angegebene Gerät.
2	Werte für das angegebene Gerät und alle funktionalen Objekte, die auf diesem Gerät gefunden wurden.

Wenn der Parameter pszParentObjectID auf WPD_DEVICE_OBJECT_ID festgelegt ist, führt die Methode eine Suche aus, die vom dwDepth-Parameter abhängig ist, wie in der folgenden Tabelle beschrieben.

dwDepth	Die Methode gibt zurück
0	Werte nur für das angegebene Gerät.
1	Werte für das angegebene Gerät und alle funktionalen Objekte, die auf diesem Gerät gefunden wurden.

Die Anforderung in der Warteschlange wird erst gestartet, wenn die Anwendung Start aufruft. Weitere Informationen zur Verwendung dieser Methode finden Sie unter IPortableDevicePropertiesBulk-Schnittstelle.

Aufgrund von Leistungsproblemen geben einige Geräte möglicherweise keine umfassende Liste von Eigenschaften zurück, wenn der pKeys-ParameterNULL ist.

Anforderungen

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

Weitere Informationen

IPortableDevicePropertiesBulk-Schnittstelle

Freigeben über