KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE (submode)

  • Artigo

A propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE permite que um submodelo seja configurado.

Resumo de uso

Os submodes a seguir são definidos da seguinte maneira.

#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE       0x00000000
#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE   0x00000001

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE é usado por uma sequência de fotos regular.

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE é usado para indicar que uma sequência de fotos é variável. Se as configurações por quadro forem especificadas, o sinalizador KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE será especificado no campo submode da estrutura KSCAMERA_EXTENDEDPROP_PHOTOMODE para indicar uma sequência de fotos variável, mesmo que nenhuma configuração de item seja especificada (a contagem de itens é 0 para todos os quadros). Quando a contagem de quadros é 1 e a contagem de itens é 0, a sequência de fotos variável reduz para uma sequência de fotos variável de quadro usando configurações globais.

Veja a seguir uma definição da estrutura KSCAMERA_EXTENDEDPROP_PHOTOMODE definida em ksmedia.h:

typedef struct tagKSCAMERA_EXTENDEDPROP_PHOTOMODE {  
    ULONG       RequestedHistoryFrames;  
    ULONG       MaxHistoryFrames;  
    ULONG       SubMode;  
    ULONG       Reserved;  
} KSCAMERA_EXTENDEDPROP_PHOTOMODE, *PKSCAMERA_EXTENDEDPROP_PHOTOMODE;

O modo de sequência de fotos variável tem as seguintes características exclusivas em uma sequência de fotos.

  • Sempre use uma sequência de fotos finita.

  • As configurações por quadro são aplicadas quando a contagem de quadros é maior que 0.

  • O driver interromperá automaticamente a sequência de fotos no final sem a necessidade do gatilho de KS_VideoControlFlag_StopPhotoSequenceCapture quando uma contagem de loops maior que 0 for especificada.

  • O último exemplo deve ser marcado com o sinalizador KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE.

  • O pipeline de captura não removerá nenhum exemplo do driver.

  • Nem o pipeline nem o driver\MFT0 geram qualquer miniatura de foto.

Essa propriedade é assíncrona e não cancelável.

Requisitos

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