VideoDeviceController Classe

Definizione

Spazio dei nomi:

Windows.Media.Devices

Controlla le impostazioni del dispositivo nella fotocamera.

public ref class VideoDeviceController sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class VideoDeviceController final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class VideoDeviceController

Public NotInheritable Class VideoDeviceController

Ereditarietà

Object Platform::Object IInspectable VideoDeviceController

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IMediaDeviceController

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per ottenere un'istanza di questo oggetto, recuperare la proprietà MediaCapture.VideoDeviceController .

Alcuni driver possono richiedere che l'anteprima del dispositivo fotocamera sia in esecuzione prima di poter determinare quali controlli sono supportati da VideoDeviceController. Se si verifica se un determinato controllo è supportato da VideoDeviceController prima dell'esecuzione del flusso di anteprima, il controllo può essere descritto come non supportato anche se è supportato dal dispositivo video.

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) e Uso di oggetti Windows Runtime in un ambiente multithreading (.NET).

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1703	15063	GetDevicePropertyByExtendedId
1703	15063	GetDevicePropertyById
1703	15063	ID
1703	15063	SetDevicePropertyByExtendedId
1703	15063	SetDevicePropertyById
1803	17134	VideoTemporalDenoisingControl
1903	18362	InfraredTorchControl
2004	19041	PanelBasedOptimizationControl

Proprietà

AdvancedPhotoControl	Ottiene il controllo avanzato di acquisizione foto per questo dispositivo video.
BacklightCompensation	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare la compensazione della luce posteriore abilitata sulla fotocamera.
Brightness	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare il livello di luminosità sulla fotocamera.
CameraOcclusionInfo	Ottiene un oggetto CameraOcclusionInfo che può essere utilizzato per ottenere lo stato di occlusione corrente di una fotocamera e ricevere notifiche quando cambia lo stato di occlusione.
Contrast	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare il livello di contrasto sulla fotocamera.
DesiredOptimization	Ottiene o imposta un valore che indica le ottimizzazioni che il dispositivo di acquisizione deve usare per classificare in ordine di priorità l'immagine di alta qualità, bassa latenza o basso consumo di energia durante l'acquisizione video.
DigitalWindowControl	Ottiene un oggetto DigitalWindowControl che consente alle app di acquisire un'area secondaria del sensore del dispositivo di acquisizione.
Exposure	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare il tempo di esposizione della fotocamera.
ExposureCompensationControl	Ottiene il controllo di compensazione dell'esposizione per questo dispositivo video.
ExposureControl	Ottiene il controllo dell'esposizione per questo dispositivo video.
ExposurePriorityVideoControl	Ottiene l'oggetto ExposurePriorityVideoControl associato a VideoDeviceController.
FlashControl	Ottiene il controllo flash per questo dispositivo video.
Focus	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare l'impostazione dello stato attivo della fotocamera.
FocusControl	Ottiene il controllo dello stato attivo per questo dispositivo video.
HdrVideoControl	Ottiene l'HdrVideoControl associato a VideoDeviceController. In questo modo è possibile abilitare e disabilitare la modalità di acquisizione video HDR (High Dynamic Range) nei dispositivi che lo supportano.
Hue	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare l'impostazione della tonalità della fotocamera.
Id	Ottiene una stringa contenente l'identificatore per il controller del dispositivo video.
InfraredTorchControl	Ottiene il controllo della torcia a infrarossi per il dispositivo video selezionato.
IsoSpeedControl	Ottiene il controllo della velocità del film ISO per questo dispositivo video.
LowLagPhoto	Ottiene il controllo foto con ritardo basso dell'otturatore per questo dispositivo video.
LowLagPhotoSequence	Ottiene il controllo sequenza foto con ritardo basso dell'otturatore per questo dispositivo video.
OpticalImageStabilizationControl	Ottiene l'oggetto OpticalImageStabilizationControl associato a VideoDeviceController.
Pan	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare l'impostazione di panoramica della fotocamera.
PanelBasedOptimizationControl	Ottiene panelBasedOptimizationControl che, se supportato, consente a un'app di abilitare il driver di dispositivo di acquisizione per ottimizzare la funzionalità di acquisizione della fotocamera in base alla posizione del pannello della fotocamera.
PhotoConfirmationControl	Ottiene il controllo di conferma della foto per questo dispositivo video.
PrimaryUse	Ottiene o imposta l'uso primario per il dispositivo.
RegionsOfInterestControl	Ottiene le aree di controllo di interesse per questo dispositivo video.
Roll	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare l'impostazione del roll della fotocamera.
SceneModeControl	Ottiene il controllo della modalità scena per questo dispositivo video.
Tilt	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare l'impostazione di inclinazione della fotocamera.
TorchControl	Ottiene il controllo torcia per questo dispositivo video.
VariablePhotoSequenceController	Ottiene variablePhotoSequenceController associato a VideoDeviceController.
VideoTemporalDenoisingControl	Ottiene l'oggetto VideoTemporalDenoisingControl associato a VideoDeviceController. In questo modo è possibile abilitare e disabilitare la denoizzazione temporale, che usa i dati delle immagini dai fotogrammi adiacenti per ridurre l'aspetto del rumore nel video acquisito, nei dispositivi che lo supportano.
WhiteBalance	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare il bilanciamento del bianco sulla fotocamera.
WhiteBalanceControl	Ottiene il controllo di bilanciamento del bianco per questo dispositivo video.
Zoom	Ottiene un oggetto MediaDeviceControl che può essere utilizzato per ottenere o impostare l'impostazione di zoom della fotocamera.
ZoomControl	Ottiene l'oggetto ZoomControl associato a VideoDeviceController.

Metodi

GetAvailableMediaStreamProperties(MediaStreamType)	Ottiene un elenco delle proprietà di codifica supportate per il dispositivo video.
GetDeviceProperty(String)	Ottiene il valore della proprietà con l'ID specificato dal driver di dispositivo di acquisizione. È possibile usare questo metodo per eseguire query su proprietà specifiche di una particolare fotocamera.
GetDevicePropertyByExtendedId(Byte[], IReference<UInt32>)	Ottiene il valore della proprietà con l'ID specificato dal driver di dispositivo di acquisizione, usando un ID esteso con informazioni di intestazione personalizzate e specificando la dimensione massima del buffer necessaria per archiviare il risultato. È possibile usare questo metodo per eseguire query su proprietà specifiche di una particolare fotocamera.
GetDevicePropertyById(String, IReference<UInt32>)	Ottiene un valore della proprietà dal driver di dispositivo di acquisizione con l'ID con informazioni di intestazione personalizzate. È possibile usare questo metodo per eseguire query su proprietà specifiche di una particolare fotocamera.
GetMediaStreamProperties(MediaStreamType)	Ottiene le proprietà di codifica per il tipo di flusso multimediale specificato per il dispositivo video.
SetDeviceProperty(String, Object)	Imposta il valore della proprietà con l'ID specificato nel driver di dispositivo di acquisizione. È possibile utilizzare questo metodo per impostare le proprietà specifiche di una particolare fotocamera.
SetDevicePropertyByExtendedId(Byte[], Byte[])	Imposta il valore della proprietà con l'ID specificato dal driver di dispositivo di acquisizione, usando un ID esteso con informazioni di intestazione personalizzate e fornendo il valore come matrice di byte.
SetDevicePropertyById(String, Object)	Imposta il valore della proprietà con l'ID specificato dal driver di dispositivo di acquisizione, usando un ID esteso con informazioni di intestazione personalizzate e fornendo il valore come oggetto .
SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)	Imposta le proprietà di codifica in modo asincrono per il tipo di flusso multimediale specificato per il dispositivo video.
TryAcquireExclusiveControl(String, MediaCaptureDeviceExclusiveControlReleaseMode)	Richiede il controllo esclusivo della fotocamera con l'ID dispositivo specificato.
TryGetPowerlineFrequency(PowerlineFrequency)	Ottiene la frequenza della linea di alimentazione locale.
TrySetPowerlineFrequency(PowerlineFrequency)	Imposta la frequenza della linea di alimentazione locale.

Vedi anche

• Esempio di dispositivo lamp