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)