Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Это важно
Вместо этого используйте API датчика UWP .
API датчика на основе COM не рекомендуется использовать в новых приложениях. Никаких дополнительных функций или улучшений не планируется, а поддержка будет ограничена.
Платформа датчика и расположения определяет константы, определяющие свойства датчиков. Производители датчиков также могут определять собственные свойства.
Платформа определяет следующие значения PROPERTYKEY для свойств датчика. Эти свойства доступны только для чтения, если иное не указано.
Свойство PROPERTYKEY для каждого определяемого платформой датчика основано на общем GUID с именем SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Это важно
Не используйте это базовое значение для определения собственных ключей свойств.
Значения свойств, назначенных как чтение и запись, могут быть указаны клиентским приложением. Значения свойств, назначенных как статические, не должны меняться с течением времени. Свойства, назначенные как обязательные, должны поддерживаться датчиком.
| Имя ключа свойства и PID | Description |
|---|---|
|
VT_UNKNOWN Только для чтения. Объект IPortableDeviceValues, содержащий имена типов данных датчика и связанные с ними точность. Значения точности представляют возможные варианты из истинных значений. Значения точности выражаются с помощью одинаковых единиц, что и поле данных, за исключением случаев, когда в противном случае документируется. |
|
VT_UNKNOWN Чтение и запись. Объект IPortableDeviceValues, содержащий имена типов данных датчика и связанные с ними значения конфиденциальности изменений. Изменение значений конфиденциальности предоставляет запросы о количестве, с помощью которого поле данных должно измениться перед вызовом события SENSOR_EVENT_DATA_UPDATED. Значения конфиденциальности выражаются с помощью тех же единиц, что и поле данных, за исключением случаев, когда это задокументировано в противном случае. Для некоторых датчиков чувствительность изменения интерпретируется как фактическое значение. Например, значение чувствительности изменения 2 для SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS представляет чувствительность плюса или минус 2 градуса Цельсия. Для других датчиков, таких как датчик внешнего света (ALS), чувствительность изменений интерпретируется как процент. Таким образом, изменение чувствительности 2 для SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX представляет плюс или минус 2% LUX. Это значение можно задать для запроса определенной конфиденциальности изменений, но несколько приложений могут использовать один и тот же датчик. Поэтому датчики определяют истинную чувствительность изменений на основе их внутренней логики. Например, датчик всегда может использовать наименьшую чувствительность к изменению, запрашиваемую любым из приложений. Если приложение задает этому свойству значение VT_NULL, драйвер устройства сбрасывает SENSOR_PROPERTY_CHANGE_SENSITIVITY значение по умолчанию. |
|
VT_UI4 Только для чтения. Значение SensorConnectionType, содержащее текущий тип подключения. |
|
VT_UI4 Чтение и запись. Текущее время создания отчета данных датчика в миллисекундах. Задание значения нуля сигналов драйверу использовать интервал отчета по умолчанию. Получив значение нуля для этого свойства, драйвер должен вернуть интервал отчета по умолчанию, а не нулевой при запросе. Приложения могут задать это значение для запроса определенного интервала отчета, но несколько приложений используют один драйвер. Таким образом, драйверы определяют истинный интервал отчета на основе внутренней логики. Например, драйвер всегда может использовать короткий интервал отчета, запрашиваемый любым вызывающим оператором. Пример использования этого свойства см. в разделе "Использование событий API датчика". |
|
VT_LPWSTR Только для чтения. Строка описания датчика. |
|
VT_LPWSTR Только для чтения. Уникально идентифицирует экземпляр устройства, с которым связан датчик. Это свойство можно использовать для определения того, содержит ли устройство несколько датчиков. Драйверы устройств не должны поддерживать это свойство, так как платформа предоставляет это значение приложениям без запросов драйверов. |
|
VT_LPWSTR Только для чтения. Обязательный, статический. Понятное имя устройства. |
|
VT_UI4 Только для чтения. Это свойство предоставляется таким образом, чтобы производители датчиков HID и разработчики драйверов имели возможность определить датчик, который отображается на уровне API с понятным именем "неизвестно". |
|
VT_VECTOR|VT_UI1 Только для чтения. Числового массива, содержащего пары значений, которые обеспечивают сопоставление между уровнями внешнего света и смещениями. Эти значения выражаются в процентах. Функция адаптивной яркости в Windows применяет эти значения к текущим предпочтениям яркости дисплея пользователя. Данные для типов векторов всегда сериализуются как VT_UI1 (массив без знака, 1-байтовых символов). Это свойство фактически содержит каждое значение как 4-байтовое целое число без знака (VT_UI4). Сведения о работе с массивами см. в разделе "Получение типов векторов". |
|
VT_UI4 Чтение и запись. Значение перечисления LOCATION_DESIRED_ACCURACY , указывающее тип обработки точности, запрошенной клиентским приложением. LOCATION_DESIRED_ACCURACY_DEFAULT (0) указывает, что датчик должен использовать точность, для которой она может оптимизировать использование электроэнергии и другие рекомендации по затратам. LOCATION_DESIRED_ACCURACY_HIGH (1) указывает, что датчик должен доставлять наиболее точный отчет. Это включает использование служб, которые могут взимать деньги или потреблять более высокий уровень заряда батареи или пропускной способности подключения. |
|
VT_LPWSTR Только для чтения. Обязательный, статический. Имя производителя. |
|
VT_UI4 Только для чтения. Обязательный, статический. Минимальный интервал, поддерживаемый оборудованием для создания отчета о данных датчика в миллисекундах. |
|
VT_LPWSTR Только для чтения. Обязательный, статический. Имя модели датчика. |
|
VT_CLSID Только для чтения. Обязательный, статический. ИДЕНТИФИКАТОР GUID, определяющий датчик. Это значение должно быть уникальным для каждого датчика на устройстве или на разных устройствах той же модели, что и на компьютере. Это свойство содержит то же значение, полученное путем вызова ISensor::GetID . |
|
VT_UKNOWN Только для чтения. Объект IPortableDeviceValues, содержащий имена полей данных датчика и связанные с ними максимальные значения. |
|
VT_UKNOWN Только для чтения. Объект IPortableDeviceValues, содержащий имена полей данных датчика и связанные с ними минимальные значения. |
|
VT_UKNOWN Только для чтения. Объект IPortableDeviceValues, содержащий имена полей данных датчика и связанные с ними разрешения. Значения разрешения представляют чувствительность к изменению поля данных. Значения разрешения выражаются с помощью одинаковых единиц, что и поле данных, за исключением случаев, когда в противном случае документируется. |
|
VT_LPWSTR Только для чтения. Обязательный, статический. Серийный номер датчика. |
|
VT_UI4 Только для чтения. Обязательное. Значение SensorState, содержащее текущее состояние датчика. |
|
VT_CLSID Только для чтения. Обязательный, статический. ИДЕНТИФИКАТОР GUID, определяющий тип датчика. Определяемые платформой типы датчиков определены в Sensor.h. |
Следующее свойство переносимых устройств Windows (WPD) должно поддерживаться всеми датчиками.
| Ключ свойства | Description |
|---|---|
|
VT_CLSID Только для чтения. Обязательный, статический. Определяет категорию датчика. |
Требования
| Требование | Ценность |
|---|---|
| Минимальная версия клиента |
Windows 7 [только классические приложения] |
| Минимально поддерживаемый сервер |
Ни одна версия не поддерживается |
| Header |
|