KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

A propriedade de controle de exposição especifica se o processamento automático ocorre para exposição ou se um valor de tempo manual é usado em vez disso.

Tabela do resumo de uso

Obter	Definir	Destino	Tipo de descritor da propriedade	Tipo de valor de propriedade
Sim	Sim	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

O valor da propriedade (dados de operação) contém uma estrutura KSCAMERA_EXTENDEDPROP_HEADER e uma estrutura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.

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

O membro Capability de KSCAMERA_EXTENDEDPROP_HEADER contém uma combinação OR bit a bit de uma ou mais das opções de processamento de vídeo a seguir.

Modo de processamento	Descrição
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO	O driver da câmera usa sua própria lógica de processamento para vídeo.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL	O driver da câmera usa um método de processamento predefinido.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK	O método de processamento de vídeo atual está bloqueado.

O membro Flags de KSCAMERA_EXTENDEDPROP_HEADER contém o sinalizador de processamento de vídeo definido no momento para a câmera. A configuração KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO pode ser combinada com KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

Esse controle de propriedade é assíncrono e cancelável.

Comentários

Modos de processamento

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

Isso indica que o processamento automático é compatível. O driver usará sua lógica interna para otimizar o processamento de vídeo. Para uma solicitação KSPROPERTY_TYPE_GET, o membro VideoProc de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING deve conter o valor determinado pelo driver atual para o processamento de vídeo.

Esse sinalizador pode ser combinado com KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK como um valor OR bit a bit.

Travando, sem combinar o modo Automático, um controle já bloqueado deve ser tratado como um no-op pelo driver da câmera. O bloqueio, em combinação com o modo Automático, um controle já bloqueado deve desencadear uma nova convergência.

Esse sinalizador não deve ser combinado com KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

Manual indica que, para esse processamento de vídeo, os valores específicos são fornecidos. Valores específicos são fornecidos ao driver.

Esse sinalizador não deve ser combinado com KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO ou KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

O sinalizador de opção de bloqueio indica que o processamento de vídeo atual está bloqueado para qualquer valor programado no momento. Por exemplo, um aplicativo pode solicitar o modo automático até que uma exposição específica seja determinada. Nesse momento, o aplicativo decidirá criar uma sequência de fotos, todas com a mesma exposição. Nesse caso, o aplicativo pode especificar o sinalizador KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

Esse sinalizador não deve ser combinado com KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Como obter a propriedade

Ao responder a uma solicitação KSPROPERTY_TYPE_GET, o driver define os membros de KSCAMERA_EXTENDEDPROP_HEADER como a seguir.

Membro	Valor
Versão	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Tamanho	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
Result	0
Funcionalidade	bit a bit OR KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL com (modo de processamento de vídeo compatível)
Sinalizadores	O modo de processamento de vídeo atual

Se nenhum modo de exposição tiver sido definido anteriormente, o driver definirá Sinalizadores como KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (padrão). Os membros da estrutura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING que segue KSCAMERA_EXTENDEDPROP_HEADER são definidos de acordo com os requisitos do modo de processamento.

O valor VideoProp.Value.ull deve conter a definição de exposição atual quando o modo é KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.

Definição da propriedade

Quando a propriedade é definida, uma solicitação KSPROPERTY_TYPE_SET, o membro Flags de KSCAMERA_EXTENDEDPROP_HEADER conterá o modo de exposição a ser definido. O membro VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING deve ser ignorado quando Sinalizadores contém o sinalizador do modo KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.

Requisitos

Versão: disponível a partir do Windows 8.1

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

Confira também

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING