KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (estratégia de desempenho do aplicativo)
Os drivers de câmera podem otimizar sua operação de captura com base nas dicas fornecidas pelo aplicativo. Essa propriedade informa ao driver para definir sua estratégia de desempenho com base em qual operação provavelmente é mais usada. Por exemplo, quando otimizado para foto, o driver da câmera pode programar o sensor para otimizar a velocidade e a resolução de exposição do sensor para menor latência do gatilho de captura de fotos para a captura de imagem. Da mesma forma, quando otimizado para vídeo, o driver da câmera pode programar o sensor para uma taxa de quadros mais alta, mas em uma resolução mais baixa.
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 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 da propriedade.
O membro Capability do KSCAMERA_EXTENDEDPROP_HEADER contém uma combinação OR bit a bit de uma ou mais das dicas de otimização a seguir.
| Dica de otimização | Descrição |
|---|---|
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO | A operação da câmera é otimizada para fotos |
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | A operação da câmera é otimizada para vídeo |
O membro Flags do KSCAMERA_EXTENDEDPROP_HEADER contém a otimização definida atualmente para a câmera (um valor).
O tipo de otimização padrão é KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Se essa propriedade for compatível com o driver da câmera, ambos os tipos de otimização deverão ter suporte.
Esse controle de propriedade é síncrono e não cancelável.
Comentários
Modos de otimização
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
Todos os drivers de câmera devem estar nesse modo até que sejam explicitamente informados para usar o modo KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO. A finalidade desse modo é otimizar o hardware da câmera para operações de foto. As operações de vídeo ainda devem estar funcionais nesse modo.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
Esse modo indica que a câmera provavelmente será usada para operações de vídeo. O driver da câmera deve otimizar o hardware para operações de vídeo para esse modo. As operações de foto devem ser funcionais, mas há prioridade de uso de recursos para operações de vídeo.
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 otimização com suporte |
| Flags | A configuração de valor de otimização atual |
Se nenhum modo de otimização tiver sido definido anteriormente, o driver definirá Sinalizadores como KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (padrão).
Definindo a propriedade
Quando a propriedade for definida, uma solicitação KSPROPERTY_TYPE_SET, o membro Flags de KSCAMERA_EXTENDEDPROP_HEADER conterá o modo de otimização a ser definido.
Requisitos
Versão: Disponível a partir do Windows 8.1
Cabeçalho: Ksmedia.h (inclua Ksmedia.h)