KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (normal e sequência)
O controle de propriedade flash define a operação de modo flash para o modo de foto normal e de sequência da câmera.
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 de KSCAMERA_EXTENDEDPROP_HEADER contém uma combinação OR bit a bit de um ou mais dos seguintes modos flash compatíveis com o driver.
| Modo flash | Descrição |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_OFF | O flash está desligado. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON | O flash está ativado no nível de intensidade padrão. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER | O flash está ativado em um nível de energia específico. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO | O flash é automático com base nas condições de iluminação. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER | O flash é automático com base nas condições de iluminação em um nível de energia específico. |
Os sinalizadores de recursos a seguir podem ser combinados com as configurações de flash anteriores, exceto para KSCAMERA_EXTENDEDPROP_FLASH_OFF.
| Recurso flash | Descrição |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION | Habilitar o recurso de redução do redeye. Esse sinalizador pode ser combinado com qualquer outra configuração. |
| KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH | Defina flash para apenas um gatilho. Esse recurso é ignorado quando a câmera não está no modo de sequência de fotos. |
| KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED | Defina flash para disparar em cada quadro de sequência. Esse recurso é ignorado quando a câmera não está no modo de sequência de fotos. |
O membro Flags do KSCAMERA_EXTENDEDPROP_HEADER contém o modo flash definido atualmente para a câmera.
O modo flash padrão para uma câmera é KSCAMERA_EXTENDEDPROP_FLASH_OFF. Se a câmera der suporte a flash, KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON e KSCAMERA_EXTENDEDPROP_FLASH_AUTO são modos necessários. Os modos KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER e KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER são opcionais.
Se o modo de sequência de fotos for compatível com a câmera, a propriedade de controle flash será necessária com suporte para KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH.
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 de modo flash com suporte |
| Flags | (A configuração do valor do modo flash atual) | (sinalizadores de recursos flash) |
Quando o modo de tocha é KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER ou KSCAMERA_EXTENDEDPROP_FLASH_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. Quando os sinalizadores de energia ajustáveis não são definidos, o valor para a configuração de intensidade normalizada é retornado em Value.ull.
Se nenhum modo flash foi definido anteriormente, os Sinalizadores serão definidos como KSCAMERA_EXTENDEDPROP_FLASH_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_FLASH_ON_ADJUSTABLEPOWER ou KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER.
Requisitos
Versão: Disponível a partir do Windows 8.1
Cabeçalho: Ksmedia.h (inclua Ksmedia.h)