KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

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á sendo streaming.

Esse controle é um substituto potencial para pan, inclinação e zoom. Esse controle só se aplica enquanto a câmera está em streaming ativamente. Ser streaming ativamente significa que um pin de visualização ou 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 Type
Versão 1 Filtrar Síncrona

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 é usado apenas 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.
OriginY 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. O WindowSize deve ser o padrão para 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; O WindowsSize plus OriginY pode não ser maior que o PorchBottom.
Reservado Defina como 0.

Requisitos

Cliente mínimo com suporte: Windows 11

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

Confira também

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPSHEADER

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

KSCAMERA_METADATA_DIGITALWINDOW