KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • Articolo

Questo controllo di proprietà esteso viene usato dal client per controllare il livello di alimentazione e il ciclo di attività di una fotocamera a infrarossi della fotocamera. Viene inviato al driver insieme a una struttura di KSCAMERA_EXTENDEDPROP_HEADER standard seguita da una struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Tabella riepilogo utilizzo

Get Set Destinazione Tipo di descrittore di proprietà Tipo valore proprietà
Sì Sì Filtra KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

Commenti

La richiesta di proprietà contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Le dimensioni totali dei dati della proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato su questa dimensione totale dei dati della proprietà.

Di seguito sono riportati i flag che possono essere inseriti nella KSCAMERA_EXTENDEDPROP_HEADER. Flag e KSCAMERA_EXTENDEDPROP_HEADER. Campi di funzionalità . Definiscono le modalità operative della torcia del runtime di integrazione.

Modalità torcia Descrizione
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF Off
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Sempre online
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION On per ogni altro fotogramma

KSCAMERA_EXTENDEDPROP_IRTORCHMODE è sempre un controllo sincrono. Il controllo non ha alcun comportamento definito quando la fotocamera non è in streaming.

Per una richiesta GET, un driver imposta i campi seguenti:

  • KSCAMERA_EXTENDEDPROP_HEADER. Funzionalità con maschera di bit dei flag KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX precedenti che rappresentano le modalità operative supportate dalla fotocamera.
  • KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna uno dei flag KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX precedenti per indicare la modalità operativa corrente.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Modalità su 0.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Minimo al livello di potenza minimo disponibile.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Massimo al livello massimo di potenza disponibile.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Passare all'incremento minimo tra i livelli di potenza.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul al livello di potenza corrente. Per impostazione predefinita, questo valore deve corrispondere allo stesso livello di alimentazione usato normalmente dal controllo di autenticazione del viso.

Per una richiesta SET, un driver usa i campi seguenti:

  • KSCAMERA_EXTENDEDPROP_HEADER. Flag per impostare una modalità operativa.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul per impostare un livello di alimentazione. Questo valore non ha alcun effetto sulla KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

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

KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Dimensione

Deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)),

Risultato

Questo valore viene ignorato per i controlli sincroni.

Funzionalità

Può essere qualsiasi combinazione di KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON o KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION. Questo campo deve segnalare almeno una funzionalità. Il campo deve segnalare KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON o KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION o entrambi. Il valore KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF è facoltativo.

Flags

Deve essere uno dei flag segnalati in Funzionalità. Il valore predefinito deve essere KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON o KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION.

La tabella seguente contiene le descrizioni e i requisiti per i campi della struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING quando si usa il controllo modalità torcia del runtime di integrazione.

Membro Descrizione

Mode

Non utilizzato. Deve essere 0.

Min/Max/Step

Il valore Min/Max/Step contiene l'incremento minimo/massimo/incremento delle impostazioni di alimentazione del runtime di integrazione. Il driver deve restituirli per le operazioni GET. (Max – Min) deve essere uniformemente divisibile per passaggio. Il passaggio potrebbe non essere zero (0).

VideoProc

Per le operazioni SET, VideoProc.Value.ul deve specificare il livello di potenza all'interno dell'intervallo descritto dal parametro Min/Max/Step. Per le operazioni GET, il driver deve restituire il livello di alimentazione corrente.

Riservato

Non utilizzato. Deve essere ignorato dal driver.

Requisiti

Intestazione

 Ksmedia.h