KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • Artigo

Esse controle de propriedade estendida é usado pelo cliente para controlar o nível de energia e o ciclo de serviço da tocha infravermelha de uma câmera IR. Ele é enviado ao driver juntamente com uma estrutura de KSCAMERA_EXTENDEDPROP_HEADER padrão seguida por uma estrutura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Tabela de Resumo de Uso

Get Set Destino Tipo de descritor de propriedade Tipo de valor da propriedade
Yes Yes Filtrar KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

Comentários

A solicitação de propriedade contém uma estrutura KSCAMERA_EXTENDEDPROP_HEADER e uma estrutura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

O tamanho total dos dados da propriedade é sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). O membro Size de KSCAMERA_EXTENDEDPROP_HEADER é definido como esse tamanho total de dados da propriedade.

Veja a seguir os sinalizadores que podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Sinalizadores e KSCAMERA_EXTENDEDPROP_HEADER. Campos de funcionalidade . Eles definem os modos de operação da tocha do IR.

Modo de tocha Descrição
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF Desativado
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Always On
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION Ativado para todos os outros quadros

KSCAMERA_EXTENDEDPROP_IRTORCHMODE é sempre um controle síncrono. O controle não tem um comportamento definido quando a câmera não está transmitindo.

Para uma solicitação GET, um driver define os seguintes campos:

  • KSCAMERA_EXTENDEDPROP_HEADER. Funcionalidade com uma máscara de bits dos sinalizadores KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX acima que representam os modos de operação compatíveis com a câmera.
  • KSCAMERA_EXTENDEDPROP_HEADER. Sinaliza para um dos sinalizadores KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX acima para indicar o modo de operação atual.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Modo como 0.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Mínimo para o nível mínimo de energia disponível.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Máximo para o nível máximo de energia disponível.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Etapa para o incremento mínimo entre os níveis de energia.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul para o nível de energia atual. Esse valor deve usar o mesmo nível de energia normalmente usado pelo controle de autenticação facial.

Para uma solicitação SET, um driver usa os seguintes campos:

  • KSCAMERA_EXTENDEDPROP_HEADER. Sinalizadores para definir um modo de operação.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul para definir um nível de energia. Esse valor não tem efeito sobre KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

A tabela a seguir contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar o controle de metadados.

Membro Descrição

Versão

Isso deve ser 1.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Tamanho

Deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)),

Result

Esse valor é ignorado para controles síncronos.

Funcionalidade

Pode ser qualquer combinação de KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON ou KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION. Esse campo deve relatar pelo menos uma funcionalidade. O campo deve relatar KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON ou KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION ou ambos. O valor KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF é opcional.

Flags

Deve ser um dos sinalizadores relatados em Capacidade. O valor padrão deve ser KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON ou KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION.

A tabela a seguir contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING ao usar o controle de modo tocha do IR.

Membro Descrição

Mode

Não utilizado. Deve ser 0.

Min/Max/Step

O Min/Max/Step contém o mínimo/máximo/incremento das configurações de energia do IR. O driver deve retorná-los para operações GET. (Max – Min) deve ser uniformemente divisível por Etapa. A etapa pode não ser zero (0).

VideoProc

Para operações SET, o VideoProc.Value.ul deve especificar o nível de energia dentro do intervalo descrito pelo parâmetro Min/Max/Step. Para operações GET, o driver deve retornar o nível de energia atual.

Reservado

Não utilizado. Deve ser ignorado pelo driver.

Requisitos

parâmetro

 Ksmedia.h