Proprietà del controllo fotocamera estesa

L'interfaccia di controllo della fotocamera estesa, disponibile a partire da Windows 8, viene usata per controllare le funzionalità della fotocamera durante l'acquisizione di immagini. Il driver può controllare queste funzionalità della fotocamera:

• flash della fotocamera
• se il pin dell'immagine e il pin del record sono reciprocamente esclusivi
• area di interesse nell'immagine
• stabilizzazione video

Il driver può anche scegliere di eseguire un'operazione di controllo della fotocamera in modo asincrono, ovvero tutte le richieste per un'operazione vengono rifiutate fino al completamento della prima richiesta. Se il driver ha eseguito correttamente operazioni di controllo della fotocamera asincrone, deve attivare l'evento KSEVENTSETID_CameraAsyncControl . Per altre informazioni, vedere KSPROPERTY_CAMERACONTROL_S_EX .

Le app UWP possono accedere a queste proprietà per configurare la fotocamera:

Proprietà

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
Usato per attivare o disattivare il flash della fotocamera o per mettere il flash in modalità automatica.

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
Usato per identificare se il pin immagine della fotocamera e il pin del record sono reciprocamente esclusivi.

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
Usato per ottenere o impostare la caratteristica dell'area di interesse di una fotocamera.

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
Usato per ottenere o impostare le caratteristiche di stabilizzazione video di una fotocamera.

Le proprietà seguenti sono disponibili a partire da Windows 8.1.

Termine	Descrizione
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	Usato per ottenere o impostare una normale modalità ancora o sequenza di foto per la fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	Usato per ottenere la frequenza di acquisizione delle foto corrente quando la modalità foto per la fotocamera è in modalità sequenza.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	Usato per ottenere o impostare la frequenza massima di acquisizione dei fotogrammi per una fotocamera quando si trova in modalità sequenza di foto.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	Usato per ottenere o impostare l'ora del trigger per il driver della fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	Usato per ottenere o impostare lo stato di avvio caldo (pronto per la fotocamera).
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	Usato per ottenere o impostare la frequenza massima possibile di fotogrammi nei pin di acquisizione video a una determinata risoluzione.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	Usato per ottenere o impostare la funzionalità di anteprima per la fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	Usato per ottenere o impostare una modalità definita dal driver che rappresenta una raccolta di controlli predefiniti.
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	Usato per ottenere o impostare il metodo flash di una fotocamera viene usato in condizioni di bassa luce.
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	Usato per ottenere o impostare l'operazione in modalità flash per la modalità foto normale e sequenza della fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	Usato per ottenere o impostare se l'elaborazione automatica si verifica per il bilanciamento del bianco o per un valore di temperatura manuale.
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	Usato per ottenere o impostare se la fotocamera è ottimizzata per l'operazione foto o video.
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	Usato per ottenere o impostare se l'elaborazione automatica si verifica per l'esposizione o un valore di tempo manuale viene usato.
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	Usato per ottenere o impostare le modalità di messa a fuoco automatica, manuale e predefinita della fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	Usato per ottenere o impostare l'impostazione ISO predefinita o automatica per la fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	Usato per ottenere il campo della visualizzazione e l'angolo di inclinazione della fotocamera.
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	Usato per ottenere o impostare l'impostazione di regolazione del controllo dell'esposizione.
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	Usato per ottenere il passo e l'angolo di yaw della posizione della fotocamera.

Queste strutture ed enumerazioni supportano l'interfaccia di controllo della fotocamera estesa:

Strutture

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

Enumerazioni

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

Il codice del driver di esempio che implementa questa interfaccia viene fornito in How To Implement Extended Camera Control Properties (Come implementare le proprietà del controllo della fotocamera estesa).