Condividi tramite

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Articolo

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM è un ID di proprietà che verrà usato per controllare i metadati dell'istogramma prodotti dal driver. Si tratta di un controllo a livello di pin solo per il pin di anteprima.

Tabella di riepilogo dell'utilizzo

Ambito Control Tipo

Versione 1

Aggiungi (Blocca)

Sincrono

I flag seguenti possono essere inseriti nella KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna il campo per controllare i metadati dell'istogramma nel driver. Il valore predefinito è HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Questo controllo deve essere utilizzato prima del controllo KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA per garantire che il buffer dei metadati di dimensioni appropriato sia allocato.

Se impostato su HISTOGRAM_OFF, il driver non recapita i metadati dell'istogramma nel pin di anteprima. Il driver non deve includere le dimensioni dei metadati dell'istogramma nel requisito delle dimensioni del buffer dei metadati.

Se impostato su HISTOGRAM_ON, il driver recapita i metadati dell'istogramma nel pin di anteprima. Il driver deve includere le dimensioni dei metadati dell'istogramma nel requisito delle dimensioni del buffer dei metadati.

Se il driver non ha la possibilità di produrre metadati istogrammi, il driver non deve implementare questo controllo. Se il driver supporta questo controllo, deve supportare anche KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA controllo.

La chiamata SET di questo controllo non ha alcun effetto quando il pin di anteprima è in qualsiasi stato superiore a quello del KSSTATE_STOP. Il driver rifiuterà la chiamata SET ricevuta se l'anteprima non è nello stato di arresto e restituisce STATUS_INVALID_DEVICE_STATE. In una chiamata GET, il driver deve restituire le impostazioni correnti nel campo Flag.

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

Membro Descrizione

Versione

Deve essere 1.

PinId

Deve essere l'ID pin associato al pin di anteprima.

Dimensione

Deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Risultato

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

Funzionalità

Deve essere 0.

Flags

Si tratta di un campo di lettura/scrittura. Può trattarsi di uno qualsiasi dei flag KSCAMERA_EXTENDEDPROP_HISTOGRAM_* definiti in precedenza.

Requisiti

Intestazione

 Ksmedia.h