KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

Artigo
06/14/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW é uma ID de propriedade que especifica o campo de exibição e o zoom da câmera enquanto a câmera está transmitindo.

Esse controle é um substituto potencial para panorâmica, inclinação e zoom. Esse controle só se aplica enquanto a câmera está transmitindo ativamente. Ser streaming ativamente significa que uma visualização ou um pino de registro deve estar em KSSTATE_RUN, pronto e capaz de entregar quadros.

Em SET, se um fluxo não estiver ativo, esses controles retornarão STATUS_INVALID_DEVICE_STATE.

Exemplos de configuração de controles KSPROPERTY podem ser encontrados no Driver de Exemplo de Câmera AVStream no GitHub.

Tabela de resumo de uso

Escopo	Control	Tipo
Versão 1	Filtrar	Síncrono

Os seguintes sinalizadores de bit controlam a ID da propriedade no driver:

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

Descrição da funcionalidade

Os sinalizadores a seguir podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Sinalizadores e KSCAMERA_EXTENDEDPROP_HEADER. Campos de funcionalidade .

Sinalizador	Descrição
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	A Janela Digital é controlada manualmente pelo aplicativo.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	A câmera ajusta automaticamente a Janela Digital para se concentrar no rosto dominante na exibição.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW é sempre um controle síncrono.

A tabela a seguir contém os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar o controle de metadados.

Membro	Descrição
Versão	Deve ser 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Tamanho	Deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
Result	Deve conter 0. Esse campo só é usado para retornar o resultado da última operação SET assíncrona.
Funcionalidade	Deve dar suporte a KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL. Opcionalmente, pode dar suporte a KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.
Flags	Deve ser KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL ou KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

Esses parâmetros serão somente leitura se KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING estiver definido no campo Sinalizadores. Se KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING for definido durante uma operação SET, os parâmetros a seguir serão ignorados.

Parâmetro	Descrição
OriginX	A origem da janela digital ao longo do eixo X no formato Q24. Deve ser o padrão 0. OriginX pode não ser menor que PorchLeft nem maior que PorchRight – WindowSize.
OrigemY	A origem da janela digital ao longo do eixo X no formato Q24. Deve ser o padrão 0. OriginX pode não ser menor que PorchLeft nem maior que PorchRight – WindowSize.
WindowSize	O tamanho da janela digital ao longo de ambos os eixos no formato Q24. Essa é a fração da exibição completa visível ao longo do eixo x e y. WindowSize deve usar como padrão 0x01000000 (1,0 no 24º trimestre). WindowSize pode não ser menor que MinWindowSize nem maior que MaxWindowSize. Além disso, WindowSize plus OriginX pode não ser maior que PorchRight; WindowsSize plus OriginY pode não ser maior que PorchBottom.
Reservado	Defina como 0.