Compartilhar via


KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE é uma ID de propriedade usada para ativar e desativar a autenticação facial.

Tabela de Resumo de Uso

Escopo Control Tipo

Versão 1

Pin

Síncrono

Os seguintes sinalizadores de bit controlam a autenticação facial no driver:

#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED                        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION  0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION          0x0000000000000004

A tabela a seguir descreve os recursos de sinalizador:

Sinalizador Descrição

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED

Funcionalidade opcional.

Quando especificado, o modo de autenticação facial de vídeo é desabilitado no driver. Esse sinalizador é mutuamente exclusivo com os sinalizadores KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION e KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION .

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION

Funcionalidade obrigatória se não houver suporte para KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION .

Quando especificado, é obrigatório definir KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION em cada exemplo, conforme descrito pelos metadados de quadro. Esse sinalizador é mutuamente exclusivo com os sinalizadores KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION e KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED . Nesse modo, espera-se que o ir alternativo seja ativado/desativado para cada quadro capturado.

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Funcionalidade obrigatória se não houver suporte para KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION .

Esse sinalizador é mutuamente exclusivo com os sinalizadores KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION e KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED . Nesse modo, espera-se que ele crie uma imagem IR com a luz IR do ambiente de plano de fundo subtraída.

Por padrão, o driver deve ter KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE definido como KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED se for uma câmera IR de uso geral. Caso contrário, ele deverá ser definido como KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION ou KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION.

As câmeras de IR devem anunciar KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED se forem esperadas para funcionar em cenários gerais além de Windows Hello.

As câmeras de IR usadas para logon facial devem dar suporte a KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION ou KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION funcionalidade, elas só devem dar suporte a um desses sinalizadores e não a ambos.

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 anunciado em apenas um pino no filtro. O pino deve ser do tipo PINNAME_VIDEO_CAPTURE ou PINNAME_VIDEO_PREVIEW, deve produzir dados do sensor ir e ser marcado como compartilhável para FrameServer.

Tamanho

Isso deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

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 pouco sábio OU dos sinalizadores de KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx com suporte, conforme definido acima.

O driver não deve anunciar KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION e KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Flags

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

Requisitos

parâmetro

Ksmedia.h