Antarmuka IDeviceSpecificProperty (devicetopology.h)

Artikel
08/23/2023

Antarmuka IDeviceSpecificProperty menyediakan akses ke nilai kontrol kontrol perangkat keras khusus perangkat. Klien mendapatkan referensi ke antarmuka IDeviceSpecificProperty dari suatu bagian dengan memanggil metode IPart::Activate dengan parameter refiid diatur ke REFIID IID_IDeviceSpecificProperty. Panggilan ke IPart::Activate hanya berhasil jika bagian mendukung antarmuka IDeviceSpecificProperty . Bagian mendukung antarmuka ini hanya jika kontrol perangkat keras yang mendasar memiliki nilai kontrol khusus perangkat dan kontrol tidak dapat diwakili secara memadai oleh antarmuka lain di DeviceTopology API.

Biasanya, properti khusus perangkat hanya berguna untuk klien yang dapat menyimpulkan arti nilai properti dari informasi seperti jenis bagian, subjenis bagian, dan nama bagian. Klien dapat memperoleh informasi ini dengan memanggil metode IPart::GetPartType, IPart::GetSubType, dan IPart::GetName .

Sebagian besar driver adaptor audio Windows mendukung Windows Driver Model (WDM) dan menggunakan properti kernel-streaming (KS) untuk mewakili parameter kontrol perangkat keras dalam subunit (disebut sebagai simpul KS). Antarmuka IDeviceSpecificProperty menyediakan akses mudah ke properti KSPROPERTY_AUDIO_DEV_SPECIFIC subunit yang memiliki nilai GUID subjenis KSNODETYPE_DEV_SPECIFIC. Untuk mendapatkan GUID subjenis subjenis subunit, panggil metode IPart::GetSubType . Untuk informasi selengkapnya tentang properti KS dan jenis node KS, lihat dokumentasi Windows DDK.

Warisan

Antarmuka IDeviceSpecificProperty mewarisi dari antarmuka IUnknown . IDeviceSpecificProperty juga memiliki jenis anggota ini:

Metode

Antarmuka IDeviceSpecificProperty memiliki metode ini.


IDeviceSpecificProperty::Get4BRange Metode Get4BRange mendapatkan rentang 4 byte dari nilai properti khusus perangkat.
IDeviceSpecificProperty::GetType Metode GetType mendapatkan jenis data dari nilai properti khusus perangkat.
IDeviceSpecificProperty::GetValue Metode GetValue mendapatkan nilai properti khusus perangkat saat ini.
IDeviceSpecificProperty::SetValue Metode SetValue menetapkan nilai properti khusus perangkat.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	devicetopology.h

Lihat juga