Partilhar via

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Artigo

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM é uma ID de propriedade que será usada para controlar os metadados de histograma produzidos pelo driver. Esse é um controle de nível de pino somente para o pino de visualização.

Tabela de resumo de uso

Escopo Control Tipo

Versão 1

Pin

Síncrono

Os sinalizadores a seguir podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Campo Sinalizadores para controlar os metadados de histograma no driver. O padrão é HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Esse controle deve ser usado antes do controle KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA para garantir que o buffer de metadados de tamanho adequado seja alocado.

Se definido como HISTOGRAM_OFF, o driver não entregará os metadados de histograma no pino de visualização. O driver não deve incluir o tamanho dos metadados de histograma em seu requisito de tamanho de buffer de metadados.

Se definido como HISTOGRAM_ON, o driver entregará os metadados de histograma no pino de visualização. O driver deve incluir o tamanho dos metadados de histograma em seu requisito de tamanho de buffer de metadados.

Se o driver não tiver a capacidade de produzir metadados de histograma, o driver não deverá implementar esse controle. Se o driver der suporte a esse controle, ele também deverá dar suporte a KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA controle.

A chamada SET desse controle não tem efeito quando o pino de visualização está em qualquer estado superior ao estado KSSTATE_STOP. O driver rejeitará a chamada SET recebida se a versão prévia não estiver no estado de parada e retornar STATUS_INVALID_DEVICE_STATE. Em uma chamada GET , o driver deve retornar as configurações atuais no campo Sinalizadores .

A tabela a seguir contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar o controle .

Membro Descrição

Versão

Isso deve ser 1.

PinId

Deve ser a ID do Pin associada ao pin de visualização.

Tamanho

Isso deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Result

Indica os resultados do erro da última operação SET . Se nenhuma operação SET tiver ocorrido, isso deverá ser 0.

Funcionalidade

Deve ser 0.

Flags

Este é um campo de leitura/gravação. Pode ser qualquer um dos sinalizadores KSCAMERA_EXTENDEDPROP_HISTOGRAM_* definidos acima.

Requisitos

parâmetro

 Ksmedia.h