Compartilhar via


KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME

Essa propriedade controla o tempo de gatilho para o driver da câmera. O tempo de gatilho é usado para determinar um quadro de referência para uma sequência de fotos.

Tabela de Resumo de Uso

Get Set Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Yes

Yes

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

O valor da propriedade (dados de operação) contém uma estrutura KSCAMERA_EXTENDEDPROP_HEADER e uma estrutura KSCAMERA_EXTENDEDPROP_VALUE . A hora do gatilho de foto, em 100 unidades nanossegundos, é definida ou retornada como valor em KSCAMERA_EXTENDEDPROP_VALUE.

O tamanho total dos dados da propriedade é sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). O membro Size de KSCAMERA_EXTENDEDPROP_HEADER é definido como esse tamanho total de dados da propriedade.

A hora do gatilho é definida ou desmarcada usando um dos sinalizadores a seguir no membro Flags do KSCAMERA_EXTENDEDPROP_HEADER.

Sinalizador de tempo de gatilho Descrição
KSPROPERTY_CAMERA_PHOTOTRIGGERTIME_CLEAR Desmarque a configuração de hora do gatilho.
KSPROPERTY_CAMERA_PHOTOTRIGGERTIME_SET Defina um novo valor de tempo de gatilho.

Esse controle de propriedade é síncrono e não cancelável..

Comentários

Obtendo a propriedade

Ao responder a uma solicitação de KSPROPERTY_TYPE_GET, o driver define os membros do KSCAMERA_EXTENDEDPROP_HEADER para o seguinte.

Membro Valor
Versão 1
PinId A ID do pino para o pino de foto.
Tamanho

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) +

sizeof(KSCAMERA_EXTENDEDPROP_VALUE)

Result

Um valor de erro resultante da tentativa de ler a taxa máxima de quadros.

Caso contrário, será 0.

Funcionalidade 0
Flags Definir ou Limpar sinalizador

Se a hora do gatilho não estiver definida como nenhum valor de hora no momento, o membro Flags de KSCAMERA_EXTENDEDPROP_HEADER deverá conter KSPROPERTY_CAMERA_PHOTOTRIGGERTIME_CLEAR valor.

Definindo a propriedade

Quando a propriedade for definida, o membro ull de KSCAMERA_EXTENDEDPROP_VALUE conterá o valor de tempo do gatilho. A hora do gatilho é definida ou desmarcada com base no sinalizador de operação. Quando o sinalizador é KSPROPERTY_CAMERA_PHOTOTRIGGERTIME_CLEAR o valor em KSCAMERA_EXTENDEDPROP_VALUE não é usado e é ignorado.

Requisitos

Versão

Disponível a partir do Windows 8.1.

parâmetro

Ksmedia.h (inclua Ksmedia.h)