KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOSTABILIZATION

Questo controllo della proprietà estesa viene usato per controllare la stabilizzazione video digitale nel driver\MFT0.

Tabella riepilogo utilizzo

Ambito	Control	Tipo
Versione 1	Aggiungi (Blocca)	Sincrono

I flag seguenti che possono essere posizionati nella KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna i flag di campo per controllare la stabilizzazione video digitale nel driver\MFT0. Per impostazione predefinita, il driver deve avere la stabilizzazione video disattivata.

#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF       0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO      0x0000000000000002

Se il driver non supporta la stabilizzazione video digitale, il driver non deve implementare questo controllo.

Se il driver supporta questo controllo, deve supportare VIDEOSTABILIZATION_ON\OFF.

La chiamata SET di questo controllo non ha alcun effetto quando il pin video è in qualsiasi stato superiore allo stato KSSTATE_STOP. Il driver rifiuta la chiamata SET ricevuta se il pin video non è nello stato di arresto e restituisce STATUS_INVALID_DEVICE_STATE. In una chiamata GET, il driver deve restituire le impostazioni correnti nel campo Flags.

Quando questo controllo viene usato nel contesto di un profilo, il profilo funge da suggerimento per il driver per la modalità qualità. Il driver può determinare se ottimizzare per bassa latenza o alta qualità quando la stabilizzazione video viene attivata in base al profilo selezionato, ad esempio, video conferenza o registrazione video di alta qualità.

Nota

PROPSETID_VIDCAP_CAMERACONTROL_VIDEO_STABILIZATION verrà deprecato per Windows 10.

Nella tabella seguente vengono descritte le funzionalità del flag.

Flag	Descrizione
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF	Si tratta di una funzionalità obbligatoria. Se specificato, la stabilizzazione video digitale è disabilitata in driver\MFT0.
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON	Si tratta di una funzionalità obbligatoria. Se specificato, la stabilizzazione video digitale è abilitata nel driver\MFT0 e l'impostazione predefinita di riempimento overscan è impostata sul driver. Questo flag si escludono a vicenda con i flag AUTO e OFF.
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO	Questa funzionalità è facoltativa. Se specificato, il driver che supporta tale funzionalità determina se la stabilizzazione video deve essere eseguita e la quantità di stabilizzazione da applicare in base all'analisi della scena e allo scenario di acquisizione. Questo flag si escludono a vicenda con i flag ON e OFF.

Nota

A seconda dell'implementazione, il buffer sovrascandato può essere allocato dal driver internamente o dalla pipeline.

Se il buffer overscanned deve essere allocato dal driver, il driver deve annunciare sia il tipo di supporto regolare che il tipo di supporto sovrascandato. MFT0 deve annunciare il tipo di supporto regolare. Quando si imposta il tipo di supporto regolare sul tipo di supporto di output di MFT0, MFT0 deve selezionare il tipo di supporto sovrascandato corrispondente dal driver annunciava tipi di supporti come tipo di supporto di input, se la stabilizzazione video è attivata. Se la stabilizzazione video è disattivata, MFT0 deve selezionare il tipo di supporto normale come tipo di supporto di input. MFT0 deve restituire MF_E_INVALIDMEDIATYPE se il tipo di supporto sovrascannato è impostato come tipo di supporto di output quando la stabilizzazione video viene attivata.

Se il buffer sovrascandato viene allocato dal driver, sia il driver che MFT0 devono annunciare i tipi di supporti regolari. MFT0 deve impostare il tipo di supporto regolare sia per il tipo di supporto di input che per il tipo di supporto di output.

Per supportare la stabilizzazione video basata su effetti (ad esempio, la stabilizzazione video non è stata eseguita né nel driver né in MFT0), il driver e MFT0 devono inoltre annunciare il tipo di supporto sovrascannato indipendentemente dal tipo di supporto sovrascandato. In questo caso, sia i tipi di supporti regolari che overscanned vengono esposti dal driver e dal MFT0. Le regole seguenti si applicano per garantire il corretto funzionamento della stabilizzazione video basata su driver e driver\MFT0.

• Se un tipo di supporto sovrascannato è impostato come tipo di supporto di output MFT0 mentre la stabilizzazione video basata su driver\MFT0 è attiva, MFT0 deve restituire MF_E_INVALIDMEDIATYPE.

• Se un tipo di supporto regolare è impostato come tipo di supporto di output MFT0, l'app deve restituire un errore nel tentativo di attivare la stabilizzazione video basata sull'effetto se la stabilizzazione video basata sull'effetto può accettare solo il tipo di supporto sovrascannato.

La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa il controllo di stabilizzazione video.

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à	Questo deve essere un OR bit per bit dei flag di KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX supportati come definito in precedenza.
Flags	Si tratta di un campo di lettura/scrittura. Può trattarsi di uno dei flag di KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX definiti sopra.

Requisiti

Intestazione

Ksmedia.h