Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ważne
Zamiast tego użyj interfejsu API czujnika platformy UWP .
Interfejs API czujnika oparty na modelu COM jest przestarzały i nie powinien być używany w nowych aplikacjach. Nie są planowane żadne dodatkowe funkcje ani ulepszenia, a pomoc techniczna będzie ograniczona.
Platforma Czujnik i Lokalizacja definiuje stałe identyfikujące właściwości czujników. Producenci czujników mogą również definiować własne właściwości.
Platforma definiuje następujące wartości PROPERTYKEY dla właściwości czujnika. Te właściwości są tylko do odczytu, chyba że określono inaczej.
Każda właściwość czujnika zdefiniowana przez platformę PROPERTYKEY jest oparta na typowym identyfikatorze GUID o nazwie SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Ważne
Nie należy używać tej wartości podstawowej do definiowania własnych kluczy właściwości.
Wartości właściwości wyznaczonych jako odczyt/zapis można określić przez aplikację kliencą. Wartości właściwości wyznaczonych jako statyczne nie mogą się zmieniać w czasie. Właściwości wyznaczone zgodnie z wymaganiami muszą być obsługiwane przez czujnik.
| Nazwa klucza właściwości i identyfikator PID | Description |
|---|---|
|
VT_UNKNOWN Tylko do odczytu. IPortableDeviceValues obiekt zawierający nazwy typów danych czujnika i ich skojarzone dokładności. Wartości dokładności reprezentują możliwe odchylenia od prawdziwych wartości. Wartości dokładności są wyrażane przy użyciu tych samych jednostek co pole danych, z wyjątkiem sytuacji, gdy w przeciwnym razie udokumentowane. |
|
VT_UNKNOWN Odczyt/zapis. IPortableDeviceValues obiekt zawierający nazwy typów danych czujnika i skojarzone z nimi wartości poufności zmian. Zmień wartości poufności zapewniają żądania dotyczące ilości, o jaką pole danych powinno ulec zmianie przed zgłoszeniam zdarzenia SENSOR_EVENT_DATA_UPDATED. Wartości poufności są wyrażane przy użyciu tych samych jednostek co pole danych, z wyjątkiem przypadków, w których udokumentowane są inaczej. W przypadku niektórych czujników czułość zmiany jest interpretowana jako rzeczywista wartość. Na przykład wartość poufności zmiany 2 dla SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS reprezentuje czułość plusa lub minus 2 stopni Celsjusza. W przypadku innych czujników, takich jak czujnik światła otoczenia (ALS), czułość zmiany jest interpretowana jako procent. Dlatego czułość zmiany 2 dla SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX reprezentuje plus lub minus 2% LUX. Możesz ustawić tę wartość, aby zażądać konkretnej poufności zmian, ale wiele aplikacji może używać tego samego czujnika. W związku z tym czujniki określają rzeczywistą czułość zmiany na podstawie ich wewnętrznej logiki. Na przykład czujnik może zawsze używać najmniejszej poufności zmian żądanej przez dowolne aplikacje. Jeśli aplikacja ustawi tę właściwość na VT_NULL, sterownik urządzenia zresetuje SENSOR_PROPERTY_CHANGE_SENSITIVITY do jego wartości domyślnej. |
|
VT_UI4 Tylko do odczytu. SensorConnectionType wartość zawierająca bieżący typ połączenia. |
|
VT_UI4 Odczyt/zapis. Bieżący czas generowania raportu danych czujnika w milisekundach. Ustawienie wartości zero sygnalizuje sterownikowi użycie domyślnego interwału raportu. Po otrzymaniu wartości zero dla tej właściwości sterownik musi zwrócić domyślny interwał raportu, a nie zero, podczas wykonywania zapytania. Aplikacje mogą ustawić tę wartość na żądanie określonego interwału raportu, ale wiele aplikacjicould używa tego samego sterownika. W związku z tym sterowniki określają prawdziwy interwał raportu na podstawie logiki wewnętrznej. Na przykład sterownik może zawsze używać najkrótszego interwału raportu żądanego przez dowolny obiekt wywołujący. Przykład użycia tej właściwości można znaleźć w temacie Using Sensor API Events (Używanie zdarzeń interfejsu API czujnika). |
|
VT_LPWSTR Tylko do odczytu. Ciąg opisu czujnika. |
|
VT_LPWSTR Tylko do odczytu. Jednoznacznie identyfikuje wystąpienie urządzenia, z którym jest skojarzony czujnik. Za pomocą tej właściwości można określić, czy urządzenie zawiera wiele czujników. Sterowniki urządzeń nie muszą obsługiwać tej właściwości, ponieważ platforma udostępnia tę wartość aplikacjom bez wykonywania zapytań dotyczących sterowników. |
|
VT_LPWSTR Tylko do odczytu. Wymagane, statyczne. Przyjazna nazwa urządzenia. |
|
VT_UI4 Tylko do odczytu. Ta właściwość jest udostępniana tak, aby producenci czujników HID i deweloperzy sterowników mogli zidentyfikować czujnik, który powierzchnie w warstwie interfejsu API ma przyjazną nazwę "nieznany". |
|
VT_VECTOR|VT_UI1 Tylko do odczytu. Zliczona tablica zawierająca pary wartości, które zapewniają mapowanie między poziomami światła otoczenia i przesunięciami. Te wartości są wyrażone jako wartości procentowe. Funkcja adaptacyjnej jasności w systemie Windows stosuje te wartości do bieżących preferencji wyświetlania użytkownika. Dane typów wektorów są zawsze serializowane jako VT_UI1 (tablica niepodpisanych, 1-bajtowych znaków). Ta właściwość zawiera każdą wartość jako 4-bajtową niepodpisaną liczbę całkowitą (VT_UI4). Aby uzyskać informacje na temat pracy z tablicami, zobacz Pobieranie typów wektorów. |
|
VT_UI4 Odczyt/zapis. Wartość z wyliczenia LOCATION_DESIRED_ACCURACY , która wskazuje typ obsługi dokładności żądanej przez aplikację kliencką. LOCATION_DESIRED_ACCURACY_DEFAULT (0) wskazuje, że czujnik powinien używać dokładności, dla której może zoptymalizować zużycie energii i inne zagadnienia dotyczące kosztów. LOCATION_DESIRED_ACCURACY_HIGH (1) wskazuje, że czujnik powinien dostarczyć najbardziej dokładny raport. Obejmuje to korzystanie z usług, które mogą pobierać pieniądze lub zużywać wyższe poziomy zasilania baterii lub przepustowości połączenia. |
|
VT_LPWSTR Tylko do odczytu. Wymagane, statyczne. Nazwa producenta. |
|
VT_UI4 Tylko do odczytu. Wymagane, statyczne. Minimalny interwał, który sprzęt obsługuje w przypadku generowania raportów o danych czujników, w milisekundach. |
|
VT_LPWSTR Tylko do odczytu. Wymagane, statyczne. Nazwa modelu czujnika. |
|
VT_CLSID Tylko do odczytu. Wymagane, statyczne. Identyfikator GUID identyfikujący czujnik. Ta wartość musi być unikatowa dla każdego czujnika na urządzeniu lub między urządzeniami tego samego modelu, co wyliczone na komputerze. Ta właściwość zawiera tę samą wartość uzyskaną przez wywołanie metody ISensor::GetID . |
|
VT_UKNOWN Tylko do odczytu. IPortableDeviceValues obiekt zawierający nazwy pól danych czujnika i skojarzone z nimi maksymalne wartości. |
|
VT_UKNOWN Tylko do odczytu. IPortableDeviceValues obiekt zawierający nazwy pól danych czujnika i skojarzone z nimi wartości minimalne. |
|
VT_UKNOWN Tylko do odczytu. IPortableDeviceValues obiekt zawierający nazwy pól danych czujnika i skojarzone z nimi rozwiązania. Wartości rozpoznawania reprezentują wrażliwość na zmianę w polu danych. Wartości rozdzielczości są wyrażane przy użyciu tych samych jednostek co pole danych, z wyjątkiem sytuacji, gdy w przeciwnym razie udokumentowane. |
|
VT_LPWSTR Tylko do odczytu. Wymagane, statyczne. Numer seryjny czujnika. |
|
VT_UI4 Tylko do odczytu. To jest wymagane. Wartość SensorState zawierająca bieżący stan czujnika. |
|
VT_CLSID Tylko do odczytu. Wymagane, statyczne. Identyfikator GUID identyfikujący typ czujnika. Typy czujników zdefiniowanych przez platformę są definiowane w pliku Sensors.h. |
Poniższa właściwość Urządzenia przenośne z systemem Windows (WPD) musi być obsługiwana przez wszystkie czujniki.
| Klucz właściwości | Description |
|---|---|
|
VT_CLSID Tylko do odczytu. Wymagane, statyczne. Definiuje kategorię czujnika. |
Requirements
| Wymaganie | Wartość |
|---|---|
| Minimalny obsługiwany klient |
Windows 7 [tylko aplikacje klasyczne] |
| Minimalny obsługiwany serwer |
Brak obsługiwanych |
| Header |
|