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)