Not
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Viktigt!
Använd UWP-sensor-API :et i stället.
COM-baserade sensor-API:et är inaktuellt och bör inte användas i nya program. Inga ytterligare funktioner eller förbättringar planeras och stödet begränsas.
Sensor- och platsplattformen definierar konstanter som identifierar egenskaper för sensorer. Sensortillverkare kan också definiera sina egna egenskaper.
Plattformen definierar följande PROPERTYKEY-värden för sensoregenskaper. Dessa egenskaper är skrivskyddade om inget annat anges.
Varje plattformsdefinierad sensoregenskap PROPERTYKEY baseras på ett gemensamt GUID med namnet SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Viktigt!
Använd inte det här basvärdet för att definiera dina egna egenskapsnycklar.
Värden för egenskaper som har angetts som läs/skriv kan anges av klientprogrammet. Värden för egenskaper som är avsedda som statiska får inte ändras över tid. Egenskaper som anges efter behov måste stödjas av sensorn.
| Namn på egenskapsnyckel och PID | Description |
|---|---|
|
VT_UNKNOWN Skrivskyddad. IPortableDeviceValues-objekt som innehåller namn på sensordatatyp och tillhörande noggrannhet. Noggrannhetsvärden representerar möjlig variation från sanna värden. Noggrannhetsvärden uttrycks med samma enheter som datafältet, förutom när de dokumenteras på annat sätt. |
|
VT_UNKNOWN Läs/skriv. IPortableDeviceValues-objekt som innehåller namn på sensordatatyp och tillhörande ändringskänslighetsvärden. Ändringskänslighetsvärden ger begäranden om hur mycket datafältet ska ändras innan händelsen SENSOR_EVENT_DATA_UPDATED utlöses. Känslighetsvärden uttrycks med hjälp av samma enheter som datafältet, förutom där annat dokumenteras. För vissa sensorer tolkas ändringskänsligheten som ett faktiskt värde. Till exempel representerar ett ändringskänslighetsvärde på 2 för SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS en känslighet på plus eller minus 2 grader Celsius. För andra sensorer, t.ex. sensorn för omgivande ljus (ALS), tolkas ändringskänsligheten som en procent. Så en ändringskänslighet på 2 för SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX representerar plus eller minus 2% av LUX. Du kan ange det här värdet för att begära en viss ändringskänslighet, men flera program kan använda samma sensor. Därför avgör sensorer den sanna ändringskänsligheten baserat på deras interna logik. Sensorn kan till exempel alltid använda den minsta ändringskänslighet som begärs av något av programmen. Om ett program anger den här egenskapen till VT_NULL återställs enhetsdrivrutinen SENSOR_PROPERTY_CHANGE_SENSITIVITY till standardvärdet. |
|
VT_UI4 Skrivskyddad. SensorConnectionType-värde som innehåller den aktuella anslutningstypen. |
|
VT_UI4 Läs/skriv. Den aktuella förflutna tiden för generering av sensordatarapporter i millisekunder. Om du anger värdet noll signaleras drivrutinen att använda sitt standardrapportintervall. När du har fått värdet noll för den här egenskapen måste en drivrutin returnera sitt standardrapportintervall, inte noll, när den efterfrågas. Program kan ange det här värdet för att begära ett visst rapportintervall, men flera program kan använda samma drivrutin. Därför avgör drivrutinerna det sanna rapportintervallet baserat på intern logik. Drivrutinen kan till exempel alltid använda det kortaste rapportintervall som begärs av en anropare. Ett exempel på hur du använder den här egenskapen finns i Använda sensor-API-händelser. |
|
VT_LPWSTR Skrivskyddad. Sensorbeskrivningssträngen. |
|
VT_LPWSTR Skrivskyddad. Identifierar unikt den enhetsinstans som sensorn är associerad med. Du kan använda den här egenskapen för att avgöra om en enhet innehåller flera sensorer. Enhetsdrivrutiner behöver inte ha stöd för den här egenskapen eftersom plattformen tillhandahåller det här värdet till program utan att köra frågor mot drivrutiner. |
|
VT_LPWSTR Skrivskyddad. Obligatoriskt, statiskt. Enhetens eget namn. |
|
VT_UI4 Skrivskyddad. Den här egenskapen tillhandahålls så att HID-sensortillverkare och drivrutinsutvecklare har ett sätt att identifiera en sensor som ytor i API-lagret med ett eget namn på "okänd". |
|
VT_VECTOR|VT_UI1 Skrivskyddad. En räknad matris som innehåller par med värden som ger en mappning mellan omgivande ljusnivåer och förskjutningar. Dessa värden uttrycks som procentandelar. Funktionen för anpassningsbar ljusstyrka i Windows tillämpar dessa värden på användarens aktuella inställning för bildskärmens ljusstyrka. Data för vektortyper serialiseras alltid som VT_UI1 (en matris med osignerade, 1 byte tecken). Den här egenskapen innehåller faktiskt varje värde som ett osignerat heltal på 4 byte (VT_UI4). Information om hur du arbetar med matriser finns i Hämta vektortyper. |
|
VT_UI4 Läs/skriv. Ett värde från LOCATION_DESIRED_ACCURACY uppräkning som anger vilken typ av noggrannhetshantering som begärs av ett klientprogram. LOCATION_DESIRED_ACCURACY_DEFAULT (0) anger att sensorn ska använda noggrannheten för vilken den kan optimera energianvändningen och andra kostnadsöverväganden. LOCATION_DESIRED_ACCURACY_HIGH (1) anger att sensorn ska leverera den bästa möjliga rapporten. Detta inkluderar användning av tjänster som kan debitera pengar eller förbruka högre nivåer av batterikraft eller anslutningsbandbredd. |
|
VT_LPWSTR Skrivskyddad. Obligatoriskt, statiskt. Tillverkarens namn. |
|
VT_UI4 Skrivskyddad. Obligatoriskt, statiskt. Det minsta intervall som maskinvaran stöder för generering av sensordatarapporter i millisekunder. |
|
VT_LPWSTR Skrivskyddad. Obligatoriskt, statiskt. Namnet på sensormodellen. |
|
VT_CLSID Skrivskyddad. Obligatoriskt, statiskt. Ett GUID som identifierar sensorn. Det här värdet måste vara unikt för varje sensor på en enhet eller mellan enheter med samma modell som uppräknade på datorn. Den här egenskapen innehåller samma värde som hämtas genom att anropa ISensor::GetID . |
|
VT_UKNOWN Skrivskyddad. IPortableDeviceValues-objekt som innehåller namn på sensordatafält och deras associerade högsta värden. |
|
VT_UKNOWN Skrivskyddad. IPortableDeviceValues-objekt som innehåller namn på sensordatafält och deras associerade minimivärden. |
|
VT_UKNOWN Skrivskyddad. IPortableDeviceValues-objekt som innehåller namn på sensordatafält och tillhörande upplösningar. Matchningsvärden representerar känslighet för ändringar i datafältet. Matchningsvärden uttrycks med hjälp av samma enheter som datafältet, förutom när de dokumenteras på annat sätt. |
|
VT_LPWSTR Skrivskyddad. Obligatoriskt, statiskt. Sensorns serienummer. |
|
VT_UI4 Skrivskyddad. Obligatoriskt. SensorState-värde som innehåller det aktuella sensortillståndet. |
|
VT_CLSID Skrivskyddad. Obligatoriskt, statiskt. Ett GUID som identifierar sensortypen. Plattformsdefinierade sensortyper definieras i Sensors.h. |
Följande WPD-egenskap (Windows Portable Devices) måste stödjas av alla sensorer.
| Egenskapsnyckel | Description |
|---|---|
|
VT_CLSID Skrivskyddad. Obligatoriskt, statiskt. Definierar sensorkategorin. |
Kravspecifikation
| Krav | Värde |
|---|---|
| Lägsta klient som stöds |
Windows 7 [endast skrivbordsappar] |
| Lägsta server som stöds |
Ingen stöds |
| Header |
|