KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS é um ID de propriedade que permite que os drivers de câmera ofereçam várias configurações de FoV (campo de visão) fixo que os usuários podem selecionar por meio da página Configurações da câmera ou de aplicativos.
Os valores de campo de exibição relatados na matriz de payload KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS devem ser classificados em ordem decrescente, por exemplo, primeiro o maior valor.
Todos os valores de FoV (campo de visão) relatados por KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS devem ser suportados em todos os tipos de mídia disponíveis que o driver escolhe suportar.
Os drivers podem fazer dimensionamento e/ou corte para obter FoVs em determinadas resoluções.
Exceções podem ser feitas suportando perfis de câmera e adicionando KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 como BlockedControl. Isso resultará no controle FIELDOFVIEW2 não suportado quando um perfil que o bloqueia é usado.
Tabela do resumo de uso
| Escopo | Obter | Definir | Control | Tipo |
|---|---|---|---|---|
| Versão 1 | Sim | Não | Filtrar | Síncrono |
Campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER
A tabela abaixo contém os requisitos dos campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar o controle.
| Membro | Descrição |
|---|---|
| Versão | Deve ser 1. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Tamanho | Deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS) |
| Resultado | Deve conter 0. Esse campo é usado apenas para retornar os resultados da última operação SET assíncrona. |
| Funcionalidade | Deve ser 0. |
| Sinalizadores | Deve ser 0. |
Payload KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS
O payload que segue a estrutura do cabeçalho é KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS obrigatório.
| Parâmetro | Descrição |
|---|---|
| DefaultDiagonalFieldOfViewInDegrees | O valor padrão do FoV (campo de visão). Deve ser um dos valores relatados no array DiscreteFoVStops. |
| DiscreteFoVStopsCount | Contagem de entradas válidas em DiscreteFovStops, máximo de 360, mínimo de 1. |
| DiscreteFoVStops | Matriz de paradas válidas do FoV (campo de visão), somente DiscreteFoVStopsCount são itens válidos. |
| Reserved | Defina como 0. |
Requisitos
Cliente mínimo com suporte: Windows 11, versão 24H2
Cabeçalho: ksmedia.h (incluir Ksmedia.h)