Informacje o stałe czujników

Ważne

Zamiast tego użyj API czujników 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 systemu Windows używa stałych na wiele sposobów. Platforma definiuje różne stałe, których można używać w kodzie sterownika czujnika. Producenci czujników mogą definiować niestandardowe stałe. Definicje stałych zdefiniowanych przez platformę można znaleźć w pliku Sensors.h. Aby uzyskać szczegółowe informacje na temat stałych czujników zdefiniowanych przez platformę, zobacz Stałe.

Organizacja czujników i danych

Platforma organizuje czujniki i dane w następujący sposób.

• Kategorie reprezentują szerokie klasy urządzeń czujników. Kategorie umożliwiają grupowanie czujników, które mogą dostarczać podobne informacje lub w jakiś sposób są powiązane w inny sposób. Każda kategoria jest reprezentowana przez stałą identyfikatora GUID. Na przykład czujniki raportujące współrzędne szerokości i długości geograficznej należą do kategorii czujnika lokalizacji. Jest to reprezentowane przez stałą SENSOR_CATEGORY_LOCATION.
• Typy czujników reprezentują określone rodzaje czujników. Każdy typ czujnika pasuje do określonej kategorii. Dwa czujniki różnych typów mogą należeć do tej samej kategorii lub różnych kategorii. Każdy typ czujnika jest reprezentowany przez stałą GUID. Na przykład globalny czujnik systemu pozycjonowania zostanie zidentyfikowany przez stałą SENSOR_TYPE_LOCATION_GPS. Jednak czujnik, który udostępnia bieżącą lokalizację przy użyciu adresu IP, zostanie zidentyfikowany przez stałą SENSOR_TYPE_LOCATION_LOOKUP. Jednak oba czujniki należą do kategorii czujników lokalizacji.
• Typy danych reprezentują określone rodzaje informacji, które może dostarczyć czujnik. Typy danych czujników mogą zawierać rzeczywistą wartość pomiaru, taką jak wysokość; informacje o jednostkach używanych do wyrażania danych, takich jak mierniki; oraz punkty odniesienia dla danych, takich jak poziom morza. Każdy typ danych jest reprezentowany przez stałą PROPERTYKEY. Na przykład typ danych reprezentujący wysokość nad poziomem morza w metrach zostanie zidentyfikowany przez stałą SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
• Podczas raportowania danych wartość jest określana jako zawarta w polu danych, a kolekcja powiązanych pól danych składa się na raport danych. Raporty danych są pakowane razem przy użyciu interfejsu IPortableDeviceValues. Każdy raport danych musi zawierać co najmniej jedno prawidłowe pole danych i sygnaturę czasową identyfikującą moment utworzenia raportu danych. Sygnatury czasowe są reprezentowane przez stałą SENSOR_DATA_TYPE_TIMESTAMP.

Inne stałe

Program musi również używać innych stałych. Te stałe obejmują następujące elementy:

• Właściwości czujnika, takie jak SENSOR_PROPERTY_DESCRIPTION. Zwykle te stałe są używane do opisywania czujnika. Niektóre właściwości czujnika muszą być dostarczane przez czujnik, niektóre właściwości mogą być ustawiane przez aplikacje klienckie, a niektóre muszą zawsze zwracać tę samą wartość z czujnika. Sekcja Właściwości czujnika zawiera te informacje dla każdej właściwości.
• Stałe zdarzeń, takie jak SENSOR_EVENT_STATE_CHANGED. Stałe dotyczące zdarzeń obejmują identyfikatory GUID , które reprezentują typy zdarzeń, oraz klucze PROPERTYKEY , które reprezentują typy parametrów zdarzeń. Te stałe będą używane dla wywołań metod, takich jak ISensor::SetEventInterest i ISensor::GetEventInterest.

Niestandardowe stałe

Producenci czujników mogą definiować niestandardowe stałe. Na przykład czujnik może należeć do kategorii, która nie jest zdefiniowana przez platformę. Aby można było użyć czujnika definiującego stałe niestandardowe, producent czujnika musi opublikować wartości, na przykład poprzez opublikowanie pliku nagłówkowego. Aby uzyskać więcej informacji, zobacz dokumentację dostarczaną z czujnikiem.