Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Důležité
Místo toho použijte rozhraní API senzoru UPW .
Rozhraní API snímače založené na modelu COM je zastaralé a nemělo by se používat v nových aplikacích. Neplánují se žádné další funkce ani vylepšení a podpora bude omezená.
Platforma Sensor and Location definuje konstanty, které identifikují vlastnosti senzorů. Výrobci senzorů mohou také definovat vlastní vlastnosti.
Platforma definuje následující hodnoty PROPERTYKEY pro vlastnosti senzoru. Tyto vlastnosti jsou jen pro čtení, pokud není uvedeno jinak.
Vlastnost PROPERTYKEY definované platformou je založená na společném identifikátoru GUID s názvem SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Důležité
Tuto základní hodnotu nepoužívejte k definování vlastních klíčů vlastností.
Hodnoty vlastností určených jako čtení a zápis lze zadat klientskou aplikací. Hodnoty vlastností určených jako statické se nesmí v průběhu času měnit. Senzor musí podporovat vlastnosti označené jako povinné.
| Název klíče vlastnosti a PID | Description |
|---|---|
|
VT_UNKNOWN Jen pro čtení. IPortableDeviceValues objekt, který obsahuje názvy datových typů snímačů a jejich přidružené přesnosti. Hodnoty přesnosti představují možnou odchylku od skutečných hodnot. Hodnoty přesnosti jsou vyjádřeny pomocí stejných jednotek jako datové pole, s výjimkou případů, kdy je uvedeno jinak. |
|
VT_UNKNOWN Čtení a zápis. IPortableDeviceValues objekt, který obsahuje názvy datových typů snímačů a jejich přidružené hodnoty citlivosti změn. Změnit hodnoty citlivosti poskytují požadavky na množství, o které se má datové pole před vyvoláním události SENSOR_EVENT_DATA_UPDATED změnit. Hodnoty citlivosti jsou vyjádřeny pomocí stejných jednotek jako datové pole, s výjimkou případů, kdy je uvedeno jinak. U některých senzorů se citlivost změn interpretuje jako skutečná hodnota. Například změna hodnoty citlivosti 2 pro SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS představuje citlivost plus nebo minus 2 stupně Celsia. U jiných senzorů, jako je senzor okolního světla (ALS), se citlivost změn interpretuje jako procento. Změna citlivosti 2 pro SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX tedy představuje plus nebo minus 2% LUX. Tuto hodnotu můžete nastavit tak, aby požadovala určitou citlivost změn, ale stejný senzor může používat více aplikací. Senzory proto na základě své interní logiky určují skutečnou citlivost změn. Senzor může například vždy používat nejmenší citlivost změn, kterou požaduje libovolná aplikace. Pokud aplikace nastaví tuto vlastnost na VT_NULL, ovladač zařízení resetuje SENSOR_PROPERTY_CHANGE_SENSITIVITY na výchozí hodnotu. |
|
VT_UI4 Jen pro čtení. Hodnota SensorConnectionType, která obsahuje aktuální typ připojení. |
|
VT_UI4 Čtení a zápis. Aktuální uplynulý čas generování sestav dat snímačů v milisekundách. Nastavení hodnoty nulových signálů, aby ovladač používal výchozí interval sestavy. Po přijetí hodnoty nula pro tuto vlastnost musí ovladač vrátit výchozí interval sestavy, nikoli nulu při dotazování. Aplikace můžou tuto hodnotu nastavit tak, aby požadovaly konkrétní interval sestavy, ale více aplikací používalo stejný ovladač. Ovladače proto určují skutečný interval sestavy na základě interní logiky. Ovladač může například vždy používat nejkratší interval sestavy, který požaduje jakýkoli volající. Příklad použití této vlastnosti naleznete v tématu Použití událostí rozhraní SENSOR API. |
|
VT_LPWSTR Jen pro čtení. Řetězec popisu senzoru. |
|
VT_LPWSTR Jen pro čtení. Jednoznačně identifikuje instanci zařízení, ke které je senzor přidružený. Tuto vlastnost můžete použít k určení, jestli zařízení obsahuje více senzorů. Ovladače zařízení nemusí tuto vlastnost podporovat, protože platforma tuto hodnotu poskytuje aplikacím bez dotazování ovladačů. |
|
VT_LPWSTR Jen pro čtení. Povinné, statické. Popisný název zařízení. |
|
VT_UI4 Jen pro čtení. Tato vlastnost je poskytována tak, aby výrobci senzorů HID a vývojáři ovladačů měli způsob identifikace senzoru, který se zobrazí ve vrstvě rozhraní API s popisným názvem "neznámý". |
|
VT_VECTOR|VT_UI1 Jen pro čtení. Počítané pole obsahující dvojice hodnot, které poskytují mapování mezi úrovněmi okolního světla a posuny. Tyto hodnoty jsou vyjádřeny jako procenta. Funkce adaptivního jasu ve Windows tyto hodnoty použije na aktuální předvolbu jasu zobrazení uživatele. Data pro typy vektorů se vždy serializují jako VT_UI1 (pole bez znaménka, 1 bajtové znaky). Tato vlastnost ve skutečnosti obsahuje každou hodnotu jako 4bajtů bez znaménka (VT_UI4). Informace o práci s poli naleznete v tématu Načítání typů vektorů. |
|
VT_UI4 Čtení a zápis. Hodnota z LOCATION_DESIRED_ACCURACY výčtu, která označuje typ zpracování přesnosti požadované klientskou aplikací. LOCATION_DESIRED_ACCURACY_DEFAULT (0) označuje, že senzor by měl používat přesnost, pro kterou může optimalizovat využití energie a další aspekty nákladů. LOCATION_DESIRED_ACCURACY_HIGH (1) značí, že senzor by měl poskytovat nejpřesnější možnou sestavu. To zahrnuje použití služeb, které můžou účtovat peníze nebo spotřebovávat vyšší úrovně energie baterie nebo šířky pásma připojení. |
|
VT_LPWSTR Jen pro čtení. Povinné, statické. Název výrobce. |
|
VT_UI4 Jen pro čtení. Povinné, statické. Minimální interval, který hardware podporuje pro generování sestav dat snímačů v milisekundách. |
|
VT_LPWSTR Jen pro čtení. Povinné, statické. Název modelu snímače. |
|
VT_CLSID Jen pro čtení. Povinné, statické. Identifikátor GUID, který identifikuje senzor. Tato hodnota musí být jedinečná pro každý senzor na zařízení nebo na všech zařízeních stejného modelu, jako je výčet v počítači. Tato vlastnost obsahuje stejnou hodnotu získanou voláním ISensor::GetID . |
|
VT_UKNOWN Jen pro čtení. IPortableDeviceValues objekt, který obsahuje názvy datových polí snímačů a jejich přidružené maximální hodnoty. |
|
VT_UKNOWN Jen pro čtení. IPortableDeviceValues objekt, který obsahuje názvy datových polí snímačů a jejich přidružené minimální hodnoty. |
|
VT_UKNOWN Jen pro čtení. IPortableDeviceValues objekt, který obsahuje názvy datových polí snímačů a jejich přidružené rozlišení. Hodnoty rozlišení představují citlivost pro změnu v datovém poli. Hodnoty rozlišení jsou vyjádřeny pomocí stejných jednotek jako datové pole, s výjimkou případů, kdy je uvedeno jinak. |
|
VT_LPWSTR Jen pro čtení. Povinné, statické. Sériové číslo senzoru. |
|
VT_UI4 Jen pro čtení. Povinné. Hodnota SensorState, která obsahuje aktuální stav senzoru. |
|
VT_CLSID Jen pro čtení. Povinné, statické. Identifikátor GUID, který identifikuje typ senzoru. Typy snímačů definované platformou jsou definovány v Sensors.h. |
Všechny senzory musí podporovat následující vlastnost Windows Portable Devices (WPD).
| Klíč atributu | Description |
|---|---|
|
VT_CLSID Jen pro čtení. Povinné, statické. Definuje kategorii snímačů. |
Požadavky
| Požadavek | Hodnota |
|---|---|
| Minimální podporovaný klient |
Windows 7 [pouze desktopové aplikace] |
| Minimální podporovaný server |
Žádné se nepodporuje. |
| Header |
|