KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE

O modo torch determina como o flash de uma câmera é usado em condições de pouca luz. Uma fonte de luz de menor intensidade é fornecida continuamente pelo flash para permitir luz suficiente para operações como foco automático.

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

O valor da propriedade (dados de operação) contém uma estrutura KSCAMERA_EXTENDEDPROP_HEADER e uma estrutura de KSCAMERA_EXTENDEDPROP_VALUE .

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

O membro Capability do KSCAMERA_EXTENDEDPROP_HEADER contém uma combinação OR bit a bit de um ou mais dos seguintes modos de tocha compatíveis com o driver.

Modo de tocha	Descrição
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF	Torchlight está desligado.
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON	Torchlight está ligado no nível de intensidade padrão.
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER	Torchlight está ligado em um nível de energia específico.

O membro Flags do KSCAMERA_EXTENDEDPROP_HEADER contém o modo de tocha atualmente definido para a câmera. O modo de tocha padrão para uma câmera é KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF e o driver deve dar suporte a esse modo de tocha.

Esse controle de propriedade é síncrono e não pode ser cancelado.

Comentários

Obtendo a propriedade

Ao responder a uma solicitação de KSPROPERTY_TYPE_GET, o driver define os membros do KSCAMERA_EXTENDEDPROP_HEADER para o seguinte.

Membro	Valor
Versão	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Tamanho	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Result	0
Funcionalidade	Valores do modo Torch com suporte.
Flags	A configuração de valor do modo de tocha atual (apenas um valor).

Quando o modo de tocha é KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER, o membro Value.ull de KSCAMERA_EXTENDEDPROP_VALUE contém um valor de nível de intensidade entre 0 e 100. Uma intensidade de 0 indica um nível mínimo e uma intensidade de 100 indica um nível de intensidade máxima.

Se nenhum modo de cena foi definido anteriormente, os Sinalizadores serão definidos como KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (padrão).

Definindo a propriedade

Quando a propriedade for definida, uma solicitação de KSPROPERTY_TYPE_SET, o membro Flags de KSCAMERA_EXTENDEDPROP_HEADER conterá o modo de tocha a ser definido. O membro Value.ull de KSCAMERA_EXTENDEDPROP_VALUE conterá o nível de intensidade a ser definido se Flags for KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER.

Requisitos

Versão	Disponível a partir do Windows 8.1.
parâmetro	Ksmedia.h (inclua Ksmedia.h)

Confira também

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE