KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (modo definido pelo driver)
A propriedade modo de cena seleciona um modo definido pelo driver que representa uma coleção de controles predefinidos. O driver determina as predefinições atribuídas a um modo de cena e habilita essas configurações de controle quando uma cena é selecionada.
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 KSCAMERA_EXTENDEDPROP_VALUE é necessário, mas o membro Value é ignorado.
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 cena compatíveis com o driver.
| Modo de cena | Descrição |
|---|---|
| KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO | Modo de perfume automático. Os controles estão em suas configurações automáticas. |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MACRO | Modo de cena de macro (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAIT | Modo de cena retrato (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORT | Modo de cena esportiva (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOW | Modo de cena de neve (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHT | Modo de cena noturna (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACH | Modo de cena de praia (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSET | Modo de cena do pôr do sol (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHT | Modo de cena de luz de velas (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPE | Modo de cena paisagem (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAIT | Modo de cena retrato noturno (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLIT | Modo de cena retroiluminada (driver definido). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUAL | Os controles são alterados manualmente e nenhum modo de cena predefinido é definido. |
O membro Flags do KSCAMERA_EXTENDEDPROP_HEADER contém o modo de cena atualmente definido para a câmera. O modo de cena padrão para uma câmera é sempre KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO.
Esse controle de propriedade é assíncrono e não cancelável.
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 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (valores de modo de cena com suporte) |
| Flags | A configuração do valor do modo de cena atual (apenas um valor) |
Se nenhum modo de cena tiver sido definido anteriormente, sinalizadores serão definidos como KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO (padrão).
Definindo a propriedade
Quando a propriedade for definida, uma solicitação de KSPROPERTY_TYPE_SET, o membro Flags do KSCAMERA_EXTENDEDPROP_HEADER conterá o modo de cena a ser habilitado.
Requisitos
Versão: Disponível a partir do Windows 8.1
Cabeçalho: Ksmedia.h (inclua Ksmedia.h)