KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE
Essa propriedade fornece a taxa máxima de quadros de captura para uma câmera quando ela está no modo de sequência de fotos.
Tabela de Resumo de Uso
| Get | Set | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Yes |
Yes |
Pin |
O valor da propriedade (dados de operação) contém uma estrutura KSCAMERA_EXTENDEDPROP_HEADER e uma estrutura KSCAMERA_EXTENDEDPROP_VALUE . A taxa máxima de quadros de foto em quadros por segundo é definida ou retornada como valor em KSCAMERA_EXTENDEDPROP_VALUE.
Não há sinalizadores definidos no membro Flags do KSCAMERA_EXTENDEDPROP_HEADER para essa propriedade.
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.
Esse controle de propriedade é assíncrono e não cancelável.
Comentários
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 | A ID do pino para o pino de foto. |
| Tamanho | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Result | Um valor de erro resultante da tentativa de ler a taxa máxima de quadros. Caso contrário, será 0. |
| Funcionalidade | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL |
| Flags | 0 |
O valor da taxa de quadros é definido no membro Ratio de KSCAMERA_EXTENDEDPROP_VALUE. Ratio.HighPart contém o numerador da taxa de quadros e Ratio.LowPart contém o denominador da taxa de quadros.
Quando o driver está no modo de sequência de fotos, pode ser necessário limitar a taxa máxima de quadros da captura de fotos. Isso é para garantir que os cenários de captura "momento no tempo", com um determinado número de quadros de histórico, estejam contidos em um período de tempo configurado. Por exemplo, com base em restrições de memória, se o aplicativo quiser capturar um segundo do histórico passado, será necessário limitar a taxa de captura para que apenas N número de quadros seja necessário.
Quando definido, o driver deve usar a taxa de quadros fornecida mesmo que a câmera possa capturar quadros rapidamente, em seguida, a taxa solicitada. Se necessário, o driver pode remover quadros extras para acomodar a taxa solicitada.
Definir o valor máximo da taxa de quadros como 0 (0 para a HighPart e 0 para a LowPart da Taxa) limpa a configuração de taxa máxima de quadros no driver e tem o mesmo efeito que pedir ao driver para fornecer quadros o mais rápido possível. Depois que a taxa de quadros for definida como 0, qualquer consulta subsequente retornará o valor da taxa máxima de quadros possível para o driver da câmera.
Requisitos
Versão |
Disponível a partir do Windows 8.1. |
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |