KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR
KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR viene usato per abilitare o disabilitare il video HDR (High Dynamic Range) sul driver. Questo è un controllo a livello di pin solo per il pin video.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà |
|---|---|---|---|
| Sì | Sì | Aggiungi (Blocca) | KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR |
I flag seguenti possono essere inseriti nella KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna il campo per controllare il video HDR. Per impostazione predefinita, il driver deve essere impostato su VIDEOHDR_OFF.
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO 0x0000000000000002
Se il driver supporta questo controllo, deve supportare VIDEOHDR_ON/VIDEOHDR_OFF.
Se il driver non supporta video HDR, il driver non deve implementare questo controllo.
Questo controllo funge da hint per il driver. Se impostato su VIDEOHDR_ON, il driver deve eseguire video HDR come miglior sforzo.
La chiamata SET di questo controllo non ha alcun effetto quando il pin video è KSSTATE_RUN stato. Il driver rifiuta la chiamata SET ricevuta se il pin video è in stato in esecuzione e restituisce STATUS_INVALID_DEVICE_STATE. In una chiamata GET, il driver deve restituire le impostazioni correnti nel campo Flags.
Nella tabella seguente vengono descritte le funzionalità del flag.
| Flag | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF | Si tratta di una funzionalità obbligatoria. Se specificato, il video HDR è disabilitato nel driver e il driver non eseguirà video HDR nel flusso video. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON | Si tratta di una funzionalità obbligatoria. Se specificato, il video HDR è abilitato nel driver e il driver eseguirà video HDR come miglior sforzo. Questo flag si escludono a vicenda con i flag VIDEOHDR_AUTO e VIDEOHDR_OFF. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO | Questa funzionalità è facoltativa. Se specificato, il driver che supporta tale funzionalità determina se il video HDR deve essere eseguito in base all'analisi della scena. Questo flag si escludono a vicenda con i flag di VIDEOHDR_ON e VIDEOHDR_OFF. |
La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa il controllo.
| Membro | Descrizione |
|---|---|
| Versione | Questo deve essere 1. |
| PinId | Deve essere l'ID pin associato al pin video. |
| Dimensione | Questa 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, questa operazione deve essere 0. |
| Funzionalità | Deve essere un OR bit per bit dei flag di KSCAMERA_EXTENDEDPROP_VIDEOHDR_* supportati definiti in precedenza. |
| Flags | Si tratta di un campo di lettura/scrittura. Questo può essere uno dei flag KSCAMERA_EXTENDEDPROP_VIDEOHDR_* definiti sopra. |
Requisiti
Client minimo supportato: Windows 11
Intestazione: ksmedia.h (include Ksmedia.h)