Metodo IPortableDevicePropertiesBulk::QueueGetValuesByObjectFormat (portabledeviceapi.h)

Articolo
03/15/2023

L'interfaccia QueueGetValuesByObjectFormat accoda una richiesta di proprietà di oggetti di un formato specifico in un dispositivo.

Sintassi

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

Parametri

[in] pguidObjectFormat

Puntatore a un GUID che specifica il formato dell'oggetto. Vengono eseguite query solo sugli oggetti di questo tipo.

[in] pszParentObjectID

Puntatore a una stringa con terminazione Null contenente l'ID oggetto dell'oggetto padre in cui deve iniziare la ricerca. Per cercare tutti gli oggetti in un dispositivo, specificare WPD_DEVICE_OBJECT_ID.

[in] dwDepth

Profondità massima da cercare al di sotto dell'elemento padre, dove 1 significa solo elementi figlio immediati. È accettabile che questo numero sia maggiore del numero effettivo di livelli. Per eseguire la ricerca in qualsiasi profondità, specificare 0xFFFFFFFF

[in] pKeys

Puntatore a un'interfaccia IPortableDeviceKeyCollection che contiene le proprietà da recuperare. Per un elenco delle proprietà definite dai dispositivi portatili Windows, vedere Proprietà e attributi. Specificare NULL per indicare tutte le proprietà dal formato specificato.

[in] pCallback

Puntatore a un'interfaccia IPortableDevicePropertiesBulkCallback implementata dall'applicazione che riceverà le informazioni recuperate.

[out] pContext

Puntatore a un GUID che verrà usato per avviare, annullare o identificare la richiesta nei callback IPortableDevicePropertiesBulkCallback , se implementata.

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	L'operazione è stata accodata correttamente.

Commenti

Se si specifica WPD_OBJECT_FORMAT_ALL per il parametro pguidObjectFormat , questo metodo restituirà le proprietà per tutti gli oggetti nel dispositivo.

Se il parametro pszParentObjectID è impostato su una stringa vuota (""), il metodo eseguirà una ricerca dipendente dal parametro dwDepth , come descritto nella tabella seguente.

dwDepth	Restituisce il metodo
0	Nessun risultato
1	Valori solo per il dispositivo specificato.
2	Valori per il dispositivo specificato e tutti gli oggetti funzionali trovati nel dispositivo.

Se il parametro pszParentObjectID è impostato su WPD_DEVICE_OBJECT_ID, il metodo eseguirà una ricerca dipendente dal parametro dwDepth , come descritto nella tabella seguente.

dwDepth	Restituisce il metodo
0	Valori solo per il dispositivo specificato.
1	Valori per il dispositivo specificato e tutti gli oggetti funzionali trovati nel dispositivo.

La richiesta in coda non viene avviata fino a quando l'applicazione non chiama Start. Per altre informazioni su come usare questo metodo, vedere Interfaccia IPortableDevicePropertiesBulk.

A causa di problemi di prestazioni, alcuni dispositivi potrebbero non restituire un elenco completo di proprietà quando il parametro pKeys è NULL.

Requisiti

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

Vedi anche

Interfaccia IPortableDevicePropertiesBulk

Condividi tramite