estrutura KSPROPERTY_CAMERACONTROL_S_EX (ksmedia.h)

Artigo
02/29/2024

Especifica uma operação de controle de câmera, incluindo a configuração do flash, as propriedades de controle de fixação de imagem, a região de interesse na imagem ou a estabilização do vídeo. Essa estrutura descreve as propriedades baseadas em filtro no conjunto de propriedades PROPSETID_VIDCAP_CAMERACONTROL.

Com suporte começando com Windows 8.

Sintaxe

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Membros

Property

Especifica uma estrutura KSPROPERTY inicializada que descreve o conjunto de propriedades, a ID da propriedade e o tipo de solicitação.

Value

Especifica o valor da propriedade. Este membro é leitura/gravação.

Flags

Indica, para Obter solicitações, a configuração atual da propriedade especificada dos valores listados abaixo. Indica, para Definir solicitações, a configuração desejada para a propriedade especificada dos valores listados abaixo. Esse membro pode ser um OR bit a bit dos seguintes valores definidos em Ksmedia.h:

Valor	Descrição
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	Indica que a configuração é controlada automaticamente. Se o driver receber esse valor, ele deverá definir o controle de câmera de forma síncrona para o modo automático e, em seguida, retornar.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	Indica que a configuração é controlada manualmente. Se o driver receber esse valor, ele deverá definir o controle de câmera de forma síncrona para o modo manual e, em seguida, retornar.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	Indica se o driver deve executar a operação de controle de câmera de forma assíncrona, em que o aplicativo emitiu um comando para o driver definir as configurações de controle da câmera antes de tirar uma foto. Esse sinalizador só deverá ser definido se KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL ou KSPROPERTY_CAMERACONTROL_FLAGS_AUTO estiverem definidos. Se esse valor de sinalizador e o valor do sinalizador KSPROPERTY_CAMERACONTROL_FLAGS_AUTO estiverem definidos, o driver deverá iniciar um thread de trabalho para iniciar uma operação de controle solicitada e rejeitar todas as outras solicitações para a mesma operação até que ela tenha concluído a primeira. Depois que a operação for concluída com êxito, o driver deverá disparar o evento KSEVENTSETID_CameraAsyncControl .

Capabilities

Se definido, indica que quando o aplicativo envia uma consulta, o driver deve retornar o valor do membro Capabilities da estrutura de controle de câmera apropriada da lista a seguir.

FocusRect

Uma estrutura RECT que especifica a região retangular na qual o dispositivo deve definir o foco. Essa estrutura está disponível apenas para aplicativos da área de trabalho do Windows.

Comentários

Quando uma operação de foco de câmera solicitada é concluída ou cancelada, o driver deve gerar um evento especificado pelo valor de enumeração KSEVENT_CAMERACONTROL_FOCUS .