Metode IPortableDeviceCapabilities::GetFunctionalCategories (portabledeviceapi.h)

Metode GetFunctionalCategories mengambil semua kategori fungsional yang didukung oleh perangkat.

Sintaks

HRESULT GetFunctionalCategories(
  [out] IPortableDevicePropVariantCollection **ppCategories
);

Parameter

[out] ppCategories

Alamat variabel yang menerima pointer ke antarmuka IPortableDevicePropVariantCollection yang menyimpan semua kategori fungsional untuk perangkat ini. Nilainya adalah GUIDjenis VT_CLSID dalam nilai PROPVARIANT yang diambil. Pemanggil harus merilis antarmuka ini ketika selesai.

Mengembalikan nilai

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

Menampilkan kode Deskripsi
S_OK
Metode berhasil.

Keterangan

Kategori fungsi ini menjelaskan jenis fungsi yang dapat dilakukan perangkat, seperti pengambilan gambar, tangkapan audio, dan penyimpanan. Metode ini biasanya sangat cepat, karena driver biasanya mengkueri perangkat hanya pada startup dan cache hasilnya.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Mengambil Kategori Fungsi yang Didukung oleh Perangkat.

Persyaratan

   
Target Platform Windows
Header portabledeviceapi.h
Pustaka PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceCapabilities

Mengambil Kategori Fungsi yang Didukung oleh Perangkat