Algılayıcı Özellikleri

Önemli

Bunun yerine UWP Algılayıcı API'sini kullanın.

COM tabanlı Algılayıcı API'si kullanım dışıdır ve yeni uygulamalarda kullanılmamalıdır. Ek özellik veya geliştirme planlanmıyor ve destek sınırlı olacak.

Algılayıcı ve Konum platformu, algılayıcıların özelliklerini tanımlayan sabitleri tanımlar. Algılayıcı üreticileri kendi özelliklerini de tanımlayabilir.

Platform, algılayıcı özellikleri için aşağıdaki PROPERTYKEY değerlerini tanımlar. Bu özellikler, aksi belirtilmedikçe salt okunur durumdadır.

Platform tanımlı her algılayıcı özelliği PROPERTYKEY , SENSOR_PROPERTY_COMMON_GUID adlı ortak bir GUID'ye dayanır:

{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.

Önemli

Kendi özellik anahtarlarınızı tanımlamak için bu temel değeri kullanmayın.

 

Okuma/yazma olarak belirlenen özelliklerin değerleri istemci uygulaması tarafından belirtilebilir. Statik olarak belirlenen özelliklerin değerleri zaman içinde değişmemelidir. Gerekli olarak belirlenen özellikler algılayıcı tarafından desteklenmelidir.

Özellik anahtarı adı ve PID Description
SENSOR_PROPERTY_ACCURACY
(PID = 17)
VT_UNKNOWN
Salt okunur. Algılayıcı veri türü adlarını ve bunların ilişkili doğruluklarını içeren IPortableDeviceValues nesnesi. Doğruluk değerleri, gerçek değerlerden olası varyasyonu temsil eder. Doğruluk değerleri, aksi belgelenmediği sürece veri alanıyla aynı birimler kullanılarak ifade edilir.
SENSOR_PROPERTY_CHANGE_SENSITIVITY
(PID = 14)
VT_UNKNOWN
Okuma/yazma. Algılayıcı veri türü adlarını ve bunların ilişkili değişiklik duyarlılığı değerlerini içeren IPortableDeviceValues nesnesi. Değişiklik duyarlılığı değerleri, SENSOR_EVENT_DATA_UPDATED olayı tetiklenmeden önce veri alanının değişmesi gereken tutar hakkında istekler sağlar.
Duyarlılık değerleri, aksinin belgelendiği durumlar dışında veri alanıyla aynı birimler kullanılarak ifade edilir.
Bazı algılayıcılar için değişiklik duyarlılığı gerçek bir değer olarak yorumlanır. Örneğin, SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS için değişiklik duyarlılığı değeri 2, artı veya eksi 2 santigrat derecelik bir duyarlılığı temsil eder.
Ortam ışığı sensörü (ALS) gibi diğer algılayıcılar için değişiklik duyarlılığı yüzde olarak yorumlanır. Bu nedenle, SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX için 2 değişiklik duyarlılığı LUX'ın artı veya eksi 2% temsil eder.
Bu değeri belirli bir değişiklik duyarlılığı istemek için ayarlayabilirsiniz, ancak birden çok uygulama aynı algılayıcıyı kullanıyor olabilir. Bu nedenle algılayıcılar, iç mantığına göre gerçek değişiklik duyarlılığını belirler. Örneğin, algılayıcı her zaman herhangi bir uygulama tarafından istenen en küçük değişiklik duyarlılığını kullanabilir.
Bir uygulama bu özelliği VT_NULL olarak ayarlarsa, cihaz sürücüsü SENSOR_PROPERTY_CHANGE_SENSITIVITY varsayılan değerine sıfırlar.
SENSOR_PROPERTY_CONNECTION_TYPE
(PID = 11)
VT_UI4
Salt okunur. Geçerli bağlantı türünü içeren SensorConnectionType değeri.
SENSOR_PROPERTY_CURRENT_REPORT_INTERVAL
(PID = 13)
VT_UI4
Okuma/yazma. Sensör verisi raporu oluşturma için geçen süre milisaniye cinsindendir.
Sıfır değerinin ayarlanması, sürücüye varsayılan rapor aralığını kullanması için sinyal verir. Bu özellik için sıfır değerini aldıktan sonra, sorgulandığında bir sürücünün sıfır değil varsayılan rapor aralığını döndürmesi gerekir.
Uygulamalar bu değeri belirli bir rapor aralığı istemek üzere ayarlayabilir, ancak birden çok uygulama aynı sürücüyü kullanıyor olabilir. Bu nedenle, sürücüler iç mantığa göre gerçek rapor aralığını belirler. Örneğin, sürücü her zaman herhangi bir arayan tarafından istenen en kısa rapor aralığını kullanabilir.
Bu özelliğin nasıl kullanılacağına ilişkin bir örnek için bkz. Algılayıcı API Olaylarını Kullanma.
SENSOR_PROPERTY_DESCRIPTION
(PID = 10)
VT_LPWSTR
Salt okunur. Algılayıcı açıklama dizesi.
SENSOR_PROPERTY_DEVICE_PATH
(PID = 15)
VT_LPWSTR
Salt okunur. Algılayıcının ilişkilendirildiği cihaz örneğini benzersiz olarak tanımlar. Bir cihazın birden çok algılayıcısı olup olmadığını belirlemek için bu özelliği kullanabilirsiniz.
Platform, sürücüleri sorgulamadan uygulamalara bu değeri sağladığından cihaz sürücülerinin bu özelliği desteklemesi gerekmez.
SENSOR_PROPERTY_FRIENDLY_NAME
(PID = 9)
VT_LPWSTR
Salt okunur. Gerekli, statik. Cihazın kolay adı.
SENSOR_PROPERTY_HID_USAGE
(PID = 22)
VT_UI4
Salt okunur. Bu özellik, HID algılayıcı üreticilerinin ve sürücü geliştiricilerinin API katmanında görünen bir algılayıcıyı "bilinmiyor" kolay adıyla tanımlamanın bir aracına sahip olması için sağlanır.
SENSOR_PROPERTY_LIGHT_RESPONSE_CURVE
(PID = 16)
VT_VECTOR|VT_UI1
Salt okunur. Ortam ışığı düzeyleri ve uzaklıklar arasında eşleme sağlayan değer çiftleri içeren sayılan dizi. Bu değerler yüzde olarak ifade edilir. Windows'daki uyarlamalı parlaklık özelliği, bu değerleri kullanıcının geçerli ekran parlaklığı tercihine uygular.
Vektör türleri için veriler her zaman VT_UI1 (işaretsiz, 1 bayt karakterden oluşan bir dizi) olarak serileştirilir. Bu özellik aslında her değeri 4 baytlık işaretsiz tamsayı (VT_UI4) olarak içerir. Dizilerle çalışma hakkında bilgi için bkz. Vektör Türlerini Alma.
SENSOR_PROPERTY_LOCATION_DESIRED_ACCURACY
(PID = 19)
VT_UI4
Okuma/yazma. LOCATION_DESIRED_ACCURACY numaralandırmasından bir istemci uygulaması tarafından istenen doğruluk işleme türünü gösteren bir değer.
LOCATION_DESIRED_ACCURACY_DEFAULT (0), algılayıcının güç kullanımını ve diğer maliyet konularını iyileştirebileceği doğruluğu kullanması gerektiğini belirtir.
LOCATION_DESIRED_ACCURACY_HIGH (1), algılayıcının mümkün olan en doğru raporu vermesi gerektiğini belirtir. Buna para harcayabilecek hizmetlerin kullanılması veya daha yüksek düzeyde pil gücü veya bağlantı bant genişliği kullanılması dahildir.
SENSOR_PROPERTY_MANUFACTURER
(PID = 6)
VT_LPWSTR
Salt okunur. Gerekli, statik. Üreticinin adı.
SENSOR_PROPERTY_MIN_REPORT_INTERVAL
(PID = 12)
VT_UI4
Salt okunur. Gerekli, statik. Donanımın sensör veri raporu oluşturma için desteklediği minimum aralık (milisaniye cinsinden).
SENSOR_PROPERTY_MODEL
(PID = 7)
VT_LPWSTR
Salt okunur. Gerekli, statik. Algılayıcı modeli adı.
SENSOR_PROPERTY_PERSISTENT_UNIQUE_ID
(PID = 5)
VT_CLSID
Salt okunur. Gerekli, statik. Algılayıcıyı tanımlayan GUID . Bu değer, bir cihazdaki veya bilgisayardaki numaralandırılmış modelin cihazlarındaki her algılayıcı için benzersiz olmalıdır. Bu özellik , ISensor::GetID çağrılarak elde edilen değeri içerir.
SENSOR_PROPERTY_RANGE_MAXIMUM
(PID = 21)
VT_UKNOWN
Salt okunur. Algılayıcı veri alanı adlarını ve bunların ilişkili en yüksek değerlerini içeren IPortableDeviceValues nesnesi.
SENSOR_PROPERTY_RANGE_MINIMUM
(PID = 20)
VT_UKNOWN
Salt okunur. Algılayıcı veri alanı adlarını ve bunların ilişkili en düşük değerlerini içeren IPortableDeviceValues nesnesi.
SENSOR_PROPERTY_RESOLUTION
(PID = 18)
VT_UKNOWN
Salt okunur. Algılayıcı veri alanı adlarını ve bunların ilişkili çözünürlüklerini içeren IPortableDeviceValues nesnesi. Çözümleme değerleri, veri alanında değişiklik yapmak için duyarlılığı temsil eder.
Çözümleme değerleri, aksi belgelenmediği sürece veri alanıyla aynı birimler kullanılarak ifade edilir.
SENSOR_PROPERTY_SERIAL_NUMBER
(PID = 8)
VT_LPWSTR
Salt okunur. Gerekli, statik. Algılayıcı seri numarası.
SENSOR_PROPERTY_STATE
(PID = 3)
VT_UI4
Salt okunur. Gerekli.
Geçerli algılayıcı durumunu içeren SensorState değeri.
SENSOR_PROPERTY_TYPE
(PID = 2)
VT_CLSID
Salt okunur. Gerekli, statik. Algılayıcı türünü tanımlayan BIR GUID . Platform tanımlı sensör türleri Sensors.h içinde tanımlanır.

Aşağıdaki Windows Taşınabilir Cihazlar (WPD) özelliği tüm algılayıcılar tarafından desteklenmelidir.

Özellik anahtarı Description
WPD_FUNCTIONAL_OBJECT_CATEGORY
VT_CLSID
Salt okunur. Gerekli, statik. Algılayıcı kategorisini tanımlar.

Gereksinimler

Gereksinim Değer
Desteklenen en düşük düzeydeki istemci
Windows 7 [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu
Hiçbiri desteklenmiyor
Header
Algılayıcılar.h

Ayrıca bakınız

GetProperties

GetProperty

IPortableDeviceValues

SetProperties