Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Belangrijk
Gebruik in plaats daarvan de UWP Sensor-API .
De SENSOR-API op basis van COM is afgeschaft en mag niet worden gebruikt in nieuwe toepassingen. Er zijn geen extra functies of verbeteringen gepland en ondersteuning wordt beperkt.
Het sensor- en locatieplatform definieert constanten die eigenschappen voor sensoren identificeren. Sensorfabrikanten kunnen ook hun eigen eigenschappen definiëren.
Het platform definieert de volgende PROPERTYKEY-waarden voor sensoreigenschappen. Deze eigenschappen zijn alleen-lezen, tenzij anders vermeld.
Elke door het platform gedefinieerde eigenschap PROPERTYKEY is gebaseerd op een algemene GUID met de naam SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Belangrijk
Gebruik deze basiswaarde niet om uw eigen eigenschapssleutels te definiëren.
Waarden voor eigenschappen die zijn aangewezen als lezen/schrijven, kunnen worden opgegeven door de clienttoepassing. Waarden voor eigenschappen die als statisch zijn aangewezen, mogen na verloop van tijd niet worden gewijzigd. Eigenschappen die zijn aangewezen als vereist, moeten worden ondersteund door de sensor.
| Naam van eigenschapssleutel en PID | Description |
|---|---|
|
VT_UNKNOWN Alleen-lezen. IPortableDeviceValues-object dat namen van sensorgegevenstypen en de bijbehorende nauwkeurigheid bevat. Nauwkeurigheidswaarden vertegenwoordigen mogelijke variaties van werkelijke waarden. Nauwkeurigheidswaarden worden uitgedrukt met behulp van dezelfde eenheden als het gegevensveld, behalve wanneer ze anders worden gedocumenteerd. |
|
VT_UNKNOWN Lezen/schrijven. IPortableDeviceValues-object dat namen van sensorgegevenstypen en de bijbehorende wijzigingsgevoeligheidswaarden bevat. Wijzigingsgevoeligheidswaarden bieden aanvragen over de hoeveelheid waarmee het gegevensveld moet worden gewijzigd voordat de SENSOR_EVENT_DATA_UPDATED gebeurtenis wordt gegenereerd. Vertrouwelijkheidswaarden worden uitgedrukt met behulp van dezelfde eenheden als het gegevensveld, behalve waar anders gedocumenteerd. Voor sommige sensoren wordt de wijzigingsgevoeligheid geïnterpreteerd als een werkelijke waarde. Een wijzigingsgevoeligheidswaarde van 2 voor SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS vertegenwoordigt bijvoorbeeld een gevoeligheid van plus of min 2 graden Celsius. Voor andere sensoren, zoals de omgevingslichtsensor (ALS), wordt de wijzigingsgevoeligheid geïnterpreteerd als een percentage. Een wijzigingsgevoeligheid van 2 voor SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX vertegenwoordigt dus plus- of min 2% van LUX. U kunt deze waarde instellen om een bepaalde wijzigingsgevoeligheid aan te vragen, maar meerdere toepassingen kunnen dezelfde sensor gebruiken. Daarom bepalen sensoren de werkelijke wijzigingsgevoeligheid op basis van hun interne logica. De sensor kan bijvoorbeeld altijd de kleinste wijzigingsgevoeligheid gebruiken die door een van de toepassingen wordt aangevraagd. Als een toepassing deze eigenschap instelt op VT_NULL, wordt het apparaatstuurprogramma SENSOR_PROPERTY_CHANGE_SENSITIVITY teruggezet op de standaardwaarde. |
|
VT_UI4 Alleen-lezen. SensorConnectionType-waarde die het huidige verbindingstype bevat. |
|
VT_UI4 Lezen/schrijven. De huidige verstreken tijd voor het genereren van sensorgegevensrapport, in milliseconden. Als u een waarde van nul signalen instelt, geeft het stuurprogramma het standaardrapportinterval aan. Nadat een waarde van nul voor deze eigenschap is ontvangen, moet een stuurprogramma het standaardrapportinterval retourneren, niet nul, wanneer er een query wordt uitgevoerd. Toepassingen kunnen deze waarde instellen om een bepaald rapportinterval aan te vragen, maar meerdere toepassingen kunnen hetzelfde stuurprogramma gebruiken. Daarom bepalen stuurprogramma's het werkelijke rapportinterval op basis van interne logica. Het stuurprogramma kan bijvoorbeeld altijd het kortste rapportinterval gebruiken dat door een beller wordt aangevraagd. Zie Sensor-API-gebeurtenissen gebruiken voor een voorbeeld van het gebruik van deze eigenschap. |
|
VT_LPWSTR Alleen-lezen. De tekenreeks van de sensorbeschrijving. |
|
VT_LPWSTR Alleen-lezen. Identificeert het apparaatexemplaar waaraan de sensor is gekoppeld, uniek. U kunt deze eigenschap gebruiken om te bepalen of een apparaat meerdere sensoren bevat. Apparaatstuurprogramma's hoeven deze eigenschap niet te ondersteunen omdat het platform deze waarde biedt aan toepassingen zonder query's uit te voeren op stuurprogramma's. |
|
VT_LPWSTR Alleen-lezen. Vereist, statisch. De beschrijvende naam voor het apparaat. |
|
VT_UI4 Alleen-lezen. Deze eigenschap wordt verstrekt zodat HID-sensorfabrikanten en stuurprogrammaontwikkelaars een manier hebben om een sensor te identificeren die in de API-laag met een beschrijvende naam van 'onbekend' wordt weergegeven. |
|
VT_VECTOR|VT_UI1 Alleen-lezen. Een getelde matrix die paren waarden bevat die een toewijzing bieden tussen omgevingslichtniveaus en offsets. Deze waarden worden uitgedrukt als percentages. De adaptieve helderheidsfunctie in Windows past deze waarden toe op de huidige voorkeur voor de helderheid van de weergave van de gebruiker. Gegevens voor vectortypen worden altijd geserialiseerd als VT_UI1 (een matrix met niet-ondertekende, 1-bytetekens). Deze eigenschap bevat eigenlijk elke waarde als een niet-ondertekend geheel getal van 4 bytes (VT_UI4). Zie Vectortypen ophalen voor informatie over het werken met matrices. |
|
VT_UI4 Lezen/schrijven. Een waarde uit de LOCATION_DESIRED_ACCURACY opsomming die het type nauwkeurigheidsafhandeling aangeeft dat door een clienttoepassing wordt aangevraagd. LOCATION_DESIRED_ACCURACY_DEFAULT (0) geeft aan dat de sensor de nauwkeurigheid moet gebruiken waarvoor het energieverbruik en andere kostenoverwegingen kunnen optimaliseren. LOCATION_DESIRED_ACCURACY_HIGH (1) geeft aan dat de sensor het meest nauwkeurige rapport moet leveren. Dit omvat het gebruik van services die mogelijk geld in rekening brengen of hogere accucapaciteit of verbindingsbandbreedte verbruiken. |
|
VT_LPWSTR Alleen-lezen. Vereist, statisch. De naam van de fabrikant. |
|
VT_UI4 Alleen-lezen. Vereist, statisch. Het minimale interval dat door de hardware wordt ondersteund voor het genereren van sensorgegevensrapport, in milliseconden. |
|
VT_LPWSTR Alleen-lezen. Vereist, statisch. De naam van het sensormodel. |
|
VT_CLSID Alleen-lezen. Vereist, statisch. Een GUID die de sensor identificeert. Deze waarde moet uniek zijn voor elke sensor op een apparaat of voor apparaten van hetzelfde model als opgesomd op de computer. Deze eigenschap bevat dezelfde waarde die is verkregen door ISensor::GetID aan te roepen. |
|
VT_UKNOWN Alleen-lezen. IPortableDeviceValues-object dat veldnamen van sensorgegevens en de bijbehorende maximumwaarden bevat. |
|
VT_UKNOWN Alleen-lezen. IPortableDeviceValues-object dat veldnamen van sensorgegevens en de bijbehorende minimumwaarden bevat. |
|
VT_UKNOWN Alleen-lezen. IPortableDeviceValues-object dat veldnamen van sensorgegevens en de bijbehorende resoluties bevat. Oplossingswaarden vertegenwoordigen de gevoeligheid die moet worden gewijzigd in het gegevensveld. Oplossingswaarden worden uitgedrukt met behulp van dezelfde eenheden als het gegevensveld, behalve wanneer dit anders wordt gedocumenteerd. |
|
VT_LPWSTR Alleen-lezen. Vereist, statisch. Het serienummer van de sensor. |
|
VT_UI4 Alleen-lezen. Verplicht. SensorState-waarde die de huidige sensorstatus bevat. |
|
VT_CLSID Alleen-lezen. Vereist, statisch. Een GUID die het sensortype identificeert. Platformgedefinieerde sensortypen worden gedefinieerd in Sensors.h. |
De volgende eigenschap Windows Portable Devices (WPD) moet door alle sensoren worden ondersteund.
| Eigenschapssleutel | Description |
|---|---|
|
VT_CLSID Alleen-lezen. Vereist, statisch. Hiermee definieert u de sensorcategorie. |
Requirements
| Requirement | Waarde |
|---|---|
| Minimaal ondersteunde client |
Windows 7 [alleen desktop-apps] |
| Minimaal ondersteunde server |
Geen ondersteuning |
| Header |
|