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)

Confira também

KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2