Condividi tramite

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

  • Articolo

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)

Vedi anche

Controllo HDR video 2.2.2.13