Compartilhar via

KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

  • Artigo

Esse controle de propriedade estendida é usado pelo cliente para consultar o driver quanto aos requisitos de buffer de metadados. Ele é enviado ao driver juntamente com uma estrutura de KSCAMERA_EXTENDEDPROP_HEADER padrão seguida por uma estrutura de KSCAMERA_EXTENDEDPROP_METADATAINFO .

Tabela de resumo de uso

Escopo Control Tipo

Versão 1

Pin

Síncrono

Veja a seguir os sinalizadores de metadados que podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Campo Sinalizadores .

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

Em uma chamada Get , o driver faz o seguinte:

  1. Preenche KSCAMERA_EXTENDEDPROP_HEADER. Funcionalidade com 0.

  2. Preencha KSCAMERA_EXTENDEDPROP_HEADER. Sinalizadores com uma combinação de qualquer um dos sinalizadores KSCAMERA_EXTENDEDPROP_METADATA_XXX acima para indicar os requisitos de memória de metadados.

  3. Preencha KSCAMERA_EXTENDEDPROP_METADATAINFO. BufferAlignment com o alinhamento de memória desejado (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). Consulte a KSCAMERA_EXTENDEDPROP_MetadataAlignment para obter os valores possíveis.

  4. Preencha KSCAMERA_EXTENDEDPROP_METADATAINFO. MaxMetadataBufferSize com o tamanho do buffer de metadados necessário em bytes.

A tabela a seguir contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar o controle de metadados.

Membro Descrição

Versão

Isso deve ser 1.

PinId

Essa deve ser a ID do Pino associada ao pino cujo quadro contém metadados. Isso pode ser qualquer um dos pinos de visualização, registro e imagem.

Tamanho

Deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_METADATAINFO),

Result

Isso indica os resultados do erro da última operação SET. Se nenhuma operação SET tiver ocorrido, ela deverá ser 0.

Funcionalidade

Isso não é utilizado e deve ser 0.

Flags

Este é um campo de leitura/gravação. Pode ser qualquer combinação de KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED ou KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY.

Requisitos

parâmetro

 Ksmedia.h