Compartilhar via


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