Propriedades comuns do sensor
Este artigo descreve as propriedades do sensor que são comuns a todos os sensores.
A tabela a seguir mostra as propriedades comuns. Para obter mais informações sobre os tipos mostrados na coluna Tipo, confira Estrutura PROPVARIANT.
| Chave da propriedade | Tipo | Acesso (R/O, R/W) | Obrigatório/Opcional | Descrição |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | Obrigatório | O tipo de sensor. O GUID consiste no mesmo formato que um sensor Windows (por exemplo, SENSOR_TYPE_ACCELEROMETER_3D). Para obter mais informações sobre tipos de sensor, consulte GUIDs de tipo de sensor. |
| PKEY_Sensor_State | VT_UI4 | R/O | Obrigatório | O estado do sensor. Para obter mais informações sobre os estados do sensor, consulte SENSOR_STATE. |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | Obrigatório | O intervalo de tempo mínimo (em milissegundos) que o hardware suporta para a geração de relatórios de dados do sensor. |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | Obrigatório | O tamanho máximo retornado em uma chamada ReadFile. Uma chamada ReadFile permite que a API nativa aloque um buffer para armazenar qualquer campo de dados. |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | Opcional | A potência do sensor expressa em miliwatts. |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | Opcional , mas necessário, se o sensor suportar histórico. |
O tamanho máximo dos dados do histórico do sensor, expresso em bytes. |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | Opcional , mas necessário, se o sensor suportar histórico. |
O intervalo de amostragem do histórico do sensor, expresso em milissegundos. |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | Opcional , mas necessário, se o sensor suportar histórico. |
O tamanho máximo do registro expresso em bytes. |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | Opcional , mas necessário, se o sensor suportar envio em lote. |
O número de eventos reservados para este sensor no buffer FIFO (first-in-first-out) do lote. Isso garante um número mínimo de eventos. Se esse valor for zero, não haverá garantia de que o sensor execute o envio em lote. |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | Opcional , mas necessário, se o sensor suportar envio em lote. |
O número máximo de eventos que podem ser agrupados no FIFO. Se esse valor for zero, o envio em lote não terá suporte para o sensor. O número real de eventos pode ser menor que esse número, pois o lote FIFO pode ser compartilhado por vários sensores. |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | Opcional , mas necessário, se o sensor suportar envio em lote. |
Indica se o sensor é capaz de despertar. Quando um sensor oferecer suporte ao envio em lote do sensor, essa propriedade deverá ser definida como VARIANT_TRUE, se o sensor puder ativar o processador do aplicativo quando o FIFO estiver cheio. E o valor deverá ser definido como VARIANT_FALSE, se o sensor não puder ativar o processador do aplicativo. Nesse caso, o estado dessa propriedade indicará a capacidade do sensor de sair do modo de espera conectado. Se o sensor oferecer suporte à ativação de um sistema do SX, essa propriedade deverá ser definida como VARIANT_TRUE e, se não oferecer suporte à ativação do SX, essa propriedade deverá ser definida como VARIANT_FALSE. |
Envio de dados em lote
Um driver de sensor que oferece suporte ao envio de dados em lote deve relatar as seguintes propriedades comuns do sensor:
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
A partir do Windows 10, versão 1511, o suporte agora está disponível para implementar o envio em lote de dados usando o driver de classe de sensor HID. Para obter informações sobre isso, consulte Controles de envio em lote do sensor.
Consulte EvtSensorSetBatchLatency para obter informações sobre a função de retorno de chamada relacionada ao envio de dados em lote.
Com a capacidade de um sensor de ativar a CPU e o sistema operacional do estado SX, PKEY_Sensor_WakeCapable também é usado como uma propriedade de enumeração que pode ser consultada no repositório de driver PnP para descobrir se o sensor é capaz de ativar o sistema do SX, além de ativar o sistema do modo de espera conectado.
Comentários
Quando o driver cliente relatar as seguintes propriedades, o driver cliente deverá usar CollectionsListGetMarshalledSizeWithoutSerialization em vez de CollectionsListGetMarshalledSize:
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes