KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION
KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION è un ID proprietà usato per controllare la correzione dello sguardo fisso sull'autista.
Questo ID proprietà controlla una correzione in flusso che un driver può eseguire per abilitare la correzione di immagini di alta qualità da usare con immagini di anteprima e registrate. La correzione in flusso deve essere abilitata e disabilitata nel driver in modo uniforme, in modo che le funzionalità siano controllate da Windows o da un'applicazione.
Esempi di impostazione dei controlli KSPROPERTY sono disponibili in AVStream Fotocamera Sample Driver in GitHub.
Eseguire l'aggiornamento al controllo KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION
A partire da Windows 11 versione 22H2, la modalità Stare è stata introdotta nel controllo di correzione dello sguardo fisso esistente come funzionalità facoltativa.
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE è un nuovo flag aggiunto al controllo KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION utilizzato per controllare la modalità Stare sul driver.
Mentre la correzione dello sguardo fisso (nota anche come Contatto oculare) risolve il problema geometrico dell'offset dello schermo della fotocamera, molti scenari video richiedono all'utente di guardare verso il basso lo schermo per lunghi periodi di tempo, immaginando anche di leggere una presentazione o un documento in una chiamata.
La modalità Stare è una forma più aggressiva di Contatto oculare che sposta continuamente i pixel degli occhi per far sembrare che tu stia parlando con il tuo pubblico anche se potresti leggere uno script e spostare rapidamente la palla oculare.
Tabella di riepilogo utilizzo
| Ambito | Controllo | Type |
|---|---|---|
| Versione 1 | Filtro | Sincrona |
I flag seguenti possono essere posizionati nella KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna il campo per controllare la modalità Di stato. Il valore predefinito deve essere Disattivato.
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 0x0000000000000002
Se il driver supporta questo controllo, deve supportare EYEGAZECORRECTION_OFF e uno o più flag.
Se il driver non supporta la correzione dello sguardo fisso, il driver non deve implementare questo controllo.
La chiamata edizione Standard T di questo controllo avrà effetto anche quando il segnaposto video o foto si trova nello stato KSSTATE_RUN. In una chiamata GET, il driver deve restituire le impostazioni correnti nel campo Flag.
Nella tabella seguente vengono descritte le funzionalità del flag.
| Flag | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF | Si tratta di una funzionalità obbligatoria. Se specificato, la correzione dello sguardo fisso è disabilitata nel driver. |
| KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON | Si tratta di una funzionalità obbligatoria. Se specificato, la correzione dello sguardo fisso è abilitata nel driver. |
| KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE | Si tratta di una funzionalità facoltativa. Se specificato insieme a KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON, la modalità Stare è abilitata nel driver. |
Nota
Dal punto di vista edizione Standard T, la modalità Stare verrà abilitata solo quando sia KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE che KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON vengono impostati contemporaneamente. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF deve essere esclusivo degli altri due bit.
La tabella seguente contiene le descrizioni e i requisiti per i campi della struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa il controllo .
| Membro | Descrizione |
|---|---|
| Versione | Deve essere 1. |
| PinId | Deve essere KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Dimensione | Deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). |
| Risultato | Non usato, deve essere 0. |
| Funzionalità | Deve essere un OR bit per bit dei flag KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* supportati definiti in precedenza. |
| Flag | Si tratta di un campo di lettura/scrittura. Può trattarsi di uno qualsiasi dei flag KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* definiti in precedenza, ad eccezione di KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE (che deve essere impostato insieme a ON per rendere effettivo) o combinazioni valide dei bit. Dal punto di vista edizione Standard T, la modalità Stare è abilitata solo quando sia KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE che KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON vengono impostati contemporaneamente. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF deve essere esclusivo degli altri 2 bit. |
Requisiti
Client minimo supportato: Windows 11, versione 22H2
Intestazione: ksmedia.h (include Ksmedia.h)
Vedi anche
Esempio di driver per la modalità verticale di segmentazione dello sfondo e sguardo fisso
KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUND edizione Standard GMENTATION