Metode IPortableDevicePropertiesBulk::QueueGetValuesByObjectFormat (portabledeviceapi.h)

Artikel
03/15/2023

Antarmuka QueueGetValuesByObjectFormat mengantrekan permintaan untuk properti objek dengan format tertentu pada perangkat.

Sintaks

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

Parameter

[in] pguidObjectFormat

Penunjuk ke GUID yang menentukan format objek. Hanya objek tipe ini yang dikueri.

[in] pszParentObjectID

Penunjuk ke string yang dihentikan null yang berisi ID objek objek dari objek induk tempat pencarian harus dimulai. Untuk mencari semua objek pada perangkat, tentukan WPD_DEVICE_OBJECT_ID.

[in] dwDepth

Kedalaman maksimum untuk mencari di bawah induk, di mana 1 berarti anak langsung saja. Dapat diterima agar jumlah ini lebih besar dari jumlah level aktual. Untuk mencari kedalaman apa pun, tentukan 0xFFFFFFFF

[in] pKeys

Penunjuk ke antarmuka IPortableDeviceKeyCollection yang berisi properti yang akan diambil. Untuk daftar properti yang ditentukan oleh Perangkat Portabel Windows, lihat Properti dan Atribut. Tentukan NULL untuk menunjukkan semua properti dari format yang ditentukan.

[in] pCallback

Arahkan ke antarmuka IPortableDevicePropertiesBulkCallback yang diimplementasikan aplikasi yang akan menerima informasi saat diambil.

[out] pContext

Arahkan ke GUID yang akan digunakan untuk memulai, membatalkan, atau mengidentifikasi permintaan di panggilan balik IPortableDevicePropertiesBulkCallback , jika diimplementasikan.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diantrekan.

Keterangan

Jika Anda menentukan WPD_OBJECT_FORMAT_ALL untuk parameter pguidObjectFormat , metode ini akan mengembalikan properti untuk semua objek pada perangkat.

Jika parameter pszParentObjectID diatur ke string kosong (""), metode akan melakukan pencarian yang bergantung pada parameter dwDepth seperti yang dijelaskan dalam tabel berikut.

dwDepth	Metode mengembalikan
0	Tidak ada hasil
1	Nilai untuk perangkat yang ditentukan saja.
2	Nilai untuk perangkat yang ditentukan dan semua objek fungsional yang ditemukan pada perangkat tersebut.

Jika parameter pszParentObjectID diatur ke WPD_DEVICE_OBJECT_ID, metode akan melakukan pencarian yang bergantung pada parameter dwDepth seperti yang dijelaskan dalam tabel berikut.

dwDepth	Metode mengembalikan
0	Nilai untuk perangkat yang ditentukan saja.
1	Nilai untuk perangkat yang ditentukan dan semua objek fungsional yang ditemukan pada perangkat tersebut.

Permintaan yang diantrekan tidak dimulai sampai aplikasi memanggil Mulai. Untuk informasi selengkapnya tentang cara menggunakan metode ini, lihat IPortableDevicePropertiesBulk Interface.

Karena masalah performa, beberapa perangkat mungkin tidak mengembalikan daftar properti yang komprehensif ketika parameter pKeys adalah NULL.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	portabledeviceapi.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDevicePropertiesBulk