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 |
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) |