Egenskaper för utökad kamerakontroll

Det utökade kamerakontrollgränssnittet, som är tillgängligt från och med Windows 8, används för att styra kamerafunktioner under bildtagningen. Föraren kan styra dessa kamerafunktioner:

• kamerans blixt
• om komponenterna "image pin" och "record pin" är ömsesidigt uteslutande
• regionen av intresse för bilden
• videostabilisering

Drivrutinen kan också välja att utföra en kamerakontrollåtgärd asynkront, vilket innebär att alla begäranden för en åtgärd avvisas tills den första begäran har slutförts. Om drivrutinen framgångsrikt har utfört asynkrona kamerakontrollåtgärder, bör den utlösa händelsen KSEVENTSETID_CameraAsyncControl. Mer information finns i KSPROPERTY_CAMERACONTROL_S_EX .

UWP-appar kan komma åt dessa egenskaper för att konfigurera kameran:

Egenskaper

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
Används för att aktivera eller inaktivera kamerans blixt eller för att sätta blixten i automatiskt läge.

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
Används för att identifiera om kamerans bildstift och inspelningsstift är ömsesidigt uteslutande.

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
Används för att hämta eller ange egenskaperna för en kameras intresseregion.

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
Används för att hämta eller ställa in en kameras egenskaper för videostabilisering.

Följande egenskaper är tillgängliga från och med Windows 8.1.

Begrepp	Beskrivning
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	Används för att hämta eller ställa in ett normalt stille- eller fotosekvensläge för kameran.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	Används för att hämta den aktuella bildfrekvensen när fotoläget för kameran är sekvensläge.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	Används för att hämta eller ange maximal bildfrekvens för en kamera när den är i fotosekvensläge.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	Används för att hämta eller ange utlösartiden för kameradrivrutinen.
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	Används för att hämta eller ställa in tillståndet för varmstart (kameraklar).
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	Används för att erhålla eller ställa in den maximala bildfrekvensen på videoinspelningsanslutningar vid en viss upplösning.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	Används för att hämta eller ange miniatyrfunktionen för kameran.
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	Används för att hämta eller ange ett drivrutinsdefinierat läge som representerar en samling förinställda kontroller.
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	Används för att hämta eller ställa in metoden som en kamerablixt används på i låga ljusförhållanden.
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	Används för att hämta eller ställa in blixtläget för både kamerans normala och sekvensfoto-läge.
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	Används för att hämta eller ange om automatisk bearbetning sker för vitbalans eller för ett manuellt temperaturvärde.
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	Används för att hämta eller ange om kameran är optimerad för foto- eller videoläge.
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	Används för att hämta eller ange om automatisk bearbetning sker för exponering eller om ett manuellt tidsvärde används.
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	Används för att hämta eller ställa in kamerans automatiska, manuella och förinställda fokuslägen.
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	Används för att hämta eller ställa in den förinställda eller automatiska ISO-inställningen för kameran.
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	Används för att få synfält och lutningsvinkel för kamerans position.
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	Används för att hämta eller ange justeringsinställningen för exponeringskontroll.
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	Används för att få lutningsvinkel och girvinkel av kamerans position.

Dessa strukturer och uppräkningar stöder det utökade kamerakontrollgränssnittet:

Strukturer

• 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

Uppräkningar

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_KAMERAKONTROLL_BILD_PIN_FUNKTION
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

Exempel på drivrutinskod som implementerar det här gränssnittet finns i Implementera utökade kamerakontrollegenskaper.