Condividi tramite

KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

  • Articolo

Questo controllo di proprietà esteso viene usato dal client per eseguire una query sul driver per i requisiti del buffer dei metadati. Viene inviato al driver insieme a una struttura di KSCAMERA_EXTENDEDPROP_HEADER standard seguita da una struttura KSCAMERA_EXTENDEDPROP_METADATAINFO .

Tabella di riepilogo dell'utilizzo

Ambito Control Tipo

Versione 1

Aggiungi (Blocca)

Sincrono

Di seguito sono riportati i flag di metadati che possono essere inseriti nella KSCAMERA_EXTENDEDPROP_HEADER. Campo Contrassegni .

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

In una chiamata Get , il driver esegue le operazioni seguenti:

  1. Riempie KSCAMERA_EXTENDEDPROP_HEADER. Funzionalità con 0.

  2. Compilare KSCAMERA_EXTENDEDPROP_HEADER. Flag con una combinazione di uno dei flag KSCAMERA_EXTENDEDPROP_METADATA_XXX precedenti per indicare i requisiti di memoria dei metadati.

  3. Riempi KSCAMERA_EXTENDEDPROP_METADATAINFO. BufferAlignment con l'allineamento della memoria desiderato (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). Per i valori possibili, vedere la KSCAMERA_EXTENDEDPROP_MetadataAlignment .

  4. Compilare KSCAMERA_EXTENDEDPROP_METADATAINFO. MaxMetadataBufferSize con le dimensioni del buffer dei metadati necessarie in byte.

La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa il controllo metadati.

Membro Descrizione

Versione

Deve essere 1.

PinId

Deve essere l'ID pin associato al pin il cui frame contiene metadati. Può trattarsi di uno dei pin di anteprima, record e immagine.

Dimensione

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

Risultato

Indica i risultati dell'errore dell'ultima operazione SET. Se non è stata eseguita alcuna operazione SET, deve essere 0.

Funzionalità

Non usato e deve essere 0.

Flags

Si tratta di un campo di lettura/scrittura. Può trattarsi di qualsiasi combinazione di KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED o KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY .

Requisiti

Intestazione

 Ksmedia.h