Condividi tramite

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

  • Articolo

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM viene usato per controllare lo zoom digitale. Viene definito nell'enumerazione KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY e viene usato per ottenere e impostare il rapporto di zoom e ottenere gli intervalli di zoom dal driver. In Windows 10 questo controllo viene esteso anche per supportare lo zoom uniforme.

Tabella riepilogo utilizzo

Ambito Control Tipo

Versione 1

Filtra

Sincrono

I flag seguenti possono essere posizionati nella KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna il campo per controllare lo zoom uniforme rispetto allo zoom diretto. Il valore predefinito è definito dal driver.

#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT  0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT   0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH   0x0000000000000002

Se il driver supporta questo controllo, deve supportare KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT.

Se il driver non supporta lo zoom digitale, il driver non deve implementare questo controllo.

Nella tabella seguente vengono descritte le funzionalità del flag.

Flag Descrizione

KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT

Si tratta di una funzionalità obbligatoria. Se specificato, il driver deciderà se è necessario applicare uno zoom diretto o uno zoom uniforme al fattore di zoom di destinazione specificato in VideoProc.Value.ul di conseguenza. Questo flag si escludono a vicenda con i flag DIRECT e SMOOTH.

KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT

Si tratta di una funzionalità obbligatoria. Se specificato, il driver eseguirà lo zoom verso il fattore di zoom di destinazione specificato in VideoProc.Value.ul il più rapidamente possibile. Questo flag si escludono a vicenda con i flag AUTO e SMOOTH.

KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH

Questa funzionalità è facoltativa. Se specificato, il driver eseguirà lo zoom verso il fattore di zoom di destinazione specificato in VideoProc.Value.ul gradualmente in modo uniforme. Il numero di fotogrammi accetta per raggiungere il fattore di zoom specificato è fino al driver. Questo flag si escludono a vicenda con i flag AUTO e DIRECT.

Per ogni chiamata GET , il driver deve segnalare gli intervalli di zoom correnti consentiti in base alle configurazioni correnti o alla configurazione.

La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa la proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Membro Descrizione

Versione

Questo deve essere 1,

PinId

Questo deve essere KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF ),

Dimensione

Questa deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING),

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 supportati definiti in precedenza.

Flags

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

La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING per la proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Membro Descrizione

Mode

Questo è inutilizzato e deve essere 0.

Min/Max/Step

Min/Max/Step contiene il valore minimo/massimo/incremento del rapporto di zoom supportato dal driver della fotocamera in formato Q16. Il driver deve restituire questi valori per le operazioni GET .

VideoProc

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

Riservato

Questo è inutilizzato. Questa operazione deve essere ignorata dal driver.

Questo controllo proprietà è sincrono e non annullabile.

Requisiti

Intestazione

 Ksmedia.h