Compartilhar via


KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR é usado para habilitar ou desabilitar o vídeo HDR (alto alcance dinâmico) no driver. Este é um controle de nível de pino somente para pino de vídeo.

Tabela de resumo de uso

Obter Definir Destino Tipo de descritor de propriedade
Sim Sim Pin KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

Os sinalizadores a seguir podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Campo Sinalizadores para controlar o HDR de vídeo. Por padrão, o driver deve ser definido como VIDEOHDR_OFF.

#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON       0x0000000000000001 
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO     0x0000000000000002 

Se o driver der suporte a esse controle, ele deverá dar suporte a VIDEOHDR_ON/VIDEOHDR_OFF.

Se o driver não der suporte ao HDR de vídeo, o driver não deverá implementar esse controle.

Esse controle serve como uma dica para o driver. Quando definido como VIDEOHDR_ON, o driver deve executar o HDR de vídeo como o melhor esforço.

A chamada SET desse controle não tem efeito quando o pino de vídeo está KSSTATE_RUN estado. O driver rejeitará a chamada SET recebida se o pino de vídeo estiver em um 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_VIDEOHDR_OFF Essa é uma funcionalidade obrigatória. Quando especificado, o VÍDEO HDR é desabilitado no driver e o driver não deve executar o HDR de vídeo no fluxo de vídeo.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON Essa é uma funcionalidade obrigatória. Quando especificado, o HDR de vídeo é habilitado no driver e o driver deve executar o HDR de vídeo como o melhor esforço. Esse sinalizador é mutuamente exclusivo com os sinalizadores VIDEOHDR_AUTO e VIDEOHDR_OFF.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO Essa funcionalidade é opcional. Quando especificado, o driver que dá suporte a essa funcionalidade determinará se o HDR de vídeo deve ser executado com base na análise de cena. Esse sinalizador é mutuamente exclusivo com os sinalizadores VIDEOHDR_ON e VIDEOHDR_OFF.

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 Pino associada ao pino de vídeo.
Tamanho 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, ela deverá ser 0.
Funcionalidade Deve ser um OR bit a bit dos sinalizadores KSCAMERA_EXTENDEDPROP_VIDEOHDR_* com suporte definidos acima.
Flags Este é um campo de leitura/gravação. Pode ser qualquer um dos sinalizadores KSCAMERA_EXTENDEDPROP_VIDEOHDR_* definidos acima.

Requisitos

Cliente mínimo com suporte: Windows 11

Cabeçalho: ksmedia.h (inclua Ksmedia.h)

Confira também

2.2.2.13 Controle HDR de vídeo