Compartilhar via


KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO

KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO é usado para controlar a foto HDR, flash sem flash e fusão de luz ultra baixa no driver. Esse é um controle de nível de pino somente para pino de foto.

Tabela de resumo de uso

Escopo Control Tipo

Versão 1

Pin

Síncrono

Veja a seguir os sinalizadores que podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Campo Sinalizadores para controlar a foto HDR, flash sem flash e fusão de luz ultra baixa. O padrão deve ser KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF.

#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO            0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR             0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF             0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT   0x0000000000000008

Se o driver der suporte a esse controle, ele deverá dar suporte a KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF.

Se o driver não der suporte a nenhuma das capturas de fotos avançadas, o driver não deverá implementar esse controle.

A chamada SET desse controle não tem efeito quando o pino de foto é KSSTATE_RUN estado. O driver rejeitará a chamada SET recebida se o pino de foto estiver em estado de execução 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 descreve os recursos de sinalizador.

Sinalizador Descrição

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF

Essa é uma funcionalidade obrigatória. Quando especificado, nenhuma foto avançada deve ser executada no driver.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO

Essa funcionalidade é opcional. Quando especificado sozinho, o driver que dá suporte a essa funcionalidade determinará se a fusão de foto HDR, Flash no Flash ou ultra low light deve ser executada com base na análise de cena. Esse sinalizador é mutuamente exclusivo com o sinalizador OFF e pode ser usado com os outros sinalizadores.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR

Essa funcionalidade é opcional. Quando especificado sozinho, o driver que dá suporte a essa funcionalidade executará o HDR de foto. Esse sinalizador é mutuamente exclusivo com os outros sinalizadores, exceto AUTO. Quando especificado junto com AUTO, o driver determinará se o HDR de foto deve ser executado com base na análise de cena.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF

Essa funcionalidade é opcional. Quando especificado sozinho, o driver que dá suporte a essa funcionalidade executará flash sem flash. Esse sinalizador é mutuamente exclusivo com os outros sinalizadores, exceto AUTO. Quando especificado junto com AUTO, o driver determinará se flash nenhum flash deve ser executado com base na análise de cena.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT

Essa funcionalidade é opcional. Quando especificado sozinho, o driver que dá suporte a essa funcionalidade executará fusão de luz ultra baixa. Esse sinalizador é mutuamente exclusivo com os outros sinalizadores, exceto AUTO. Quando especificado junto com AUTO, o driver determinará se a fusão de luz ultra baixa deve ser executada com base na análise de cena.

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 pino de foto.

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 um OR bit a bit dos sinalizadores KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* com suporte definidos acima.

Flags

Este é um campo de leitura/gravação. Esse pode ser qualquer um dos sinalizadores KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* definidos acima.

Requisitos

parâmetro

Ksmedia.h