estrutura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING (ksmedia.h)

O KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING é uma estrutura de conteúdo de propriedade para configurações de processamento de vídeo relacionadas ao balanceamento de branco, ao modo de exposição e ao modo de foco.

Sintaxe

typedef struct tagKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING {
  ULONG                       Mode;
  LONG                        Min;
  LONG                        Max;
  LONG                        Step;
  KSCAMERA_EXTENDEDPROP_VALUE VideoProc;
  ULONGLONG                   Reserved;
} KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, *PKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING;

Membros

Mode

O tipo de modo de processamento de vídeo. Atualmente, esse membro é usado para controlar o equilíbrio em branco. Os valores possíveis para Mode são os seguintes.

Valor	Descrição
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE	Um valor de temperatura de imagem é usado para definir o equilíbrio em branco em graus Kelvin.
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET	A configuração de saldo em branco é um valor predefinido especificado em VideoProc.

Este membro não é usado para KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE e KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE. Nesses casos, ele deve ser definido como 0.

Min

O valor mínimo do intervalo para a configuração em VideoProc.

Max

O valor de intervalo máximo para a configuração em VideoProc.

Step

O incremento no valor, quando aplicável, para a configuração em VideoProc quando Mode é definido como KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE.

-ou-

O incremento no valor, quando aplicável, para a configuração em VideoProc quando a exposição de configuração é definida manualmente com KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

VideoProc

Usando a propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE, quando Mode é definido como KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET, o valor VideoProc.Value.ul é um dos seguintes.

Valor	Descrição
KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY	Predefinição de saldo em branco para condições cloudy.
KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT	Predefinição de saldo em branco para a luz do dia nublada.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH	Predefinição de balanceamento branco para compensar a iluminação flash.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT	Predefinição de equilíbrio branco para compensar a iluminação fluorescente.
KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN	Predefinição de saldo em branco para compensar a iluminação emitida por tungstênio.
KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT	Predefinição de equilíbrio branco para compensar a iluminação à luz de velas.

Usando a propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE, quando Mode é definido como KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, o valor VideoProc.Value.ul é um valor de temperatura em graus Kelvin.

Usando a propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE, quando usada para definir manualmente a exposição, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL, o valor VideoProc.Value.ul é o tempo de exposição em 100 unidades nanossegundos.

Usando a propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE, esse membro contém o valor de comprimento focal para o modo de foco manual, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Reserved

Reservado.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.1.
cabeçalho	ksmedia.h (inclua Ksmedia.h)

Consulte também

KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE