KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

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