VideoDeviceController Klasse

Definition

Namespace:

Windows.Media.Devices

Steuert Geräteeinstellungen auf der Kamera.

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

Vererbung

Object Platform::Object IInspectable VideoDeviceController

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IMediaDeviceController

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Um eine instance dieses Objekts abzurufen, rufen Sie die MediaCapture.VideoDeviceController-Eigenschaft ab.

Einige Treiber erfordern möglicherweise, dass sich die Kameragerätevorschau in einem ausgeführten Zustand befindet, bevor ermittelt werden kann, welche Steuerelemente vom VideoDeviceController unterstützt werden. Wenn Sie überprüfen, ob ein bestimmtes Steuerelement vom VideoDeviceController unterstützt wird, bevor der Vorschaudatenstrom ausgeführt wird, wird das Steuerelement möglicherweise als nicht unterstützt beschrieben, obwohl es vom Videogerät unterstützt wird.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1703	15063	GetDevicePropertyByExtendedId
1703	15063	GetDevicePropertyById
1703	15063	Id
1703	15063	SetDevicePropertyByExtendedId
1703	15063	SetDevicePropertyById
1803	17134	VideoTemporalDenoisingControl
1903	18362	InfraredTorchControl
2004	19041	PanelBasedOptimizationControl

Eigenschaften

AdvancedPhotoControl	Ruft das erweiterte Fotoaufnahmesteuerelement für dieses Videogerät ab.
BacklightCompensation	Ruft ein MediaDeviceControl-Objekt ab, mit dem abgerufen oder festgelegt werden kann, ob die Rücklichtkompensation auf der Kamera aktiviert ist.
Brightness	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Helligkeitsstufe auf der Kamera verwendet werden kann.
CameraOcclusionInfo	Ruft ein CameraOcclusionInfo-Objekt ab, das verwendet werden kann, um den aktuellen Okklusionszustand einer Kamera abzurufen und Benachrichtigungen zu erhalten, wenn sich der Okklusionszustand ändert.
Contrast	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen des Kontrastpegels auf der Kamera verwendet werden kann.
DesiredOptimization	Ruft einen Wert ab, der die Optimierungen angibt, die das Aufnahmegerät zur Priorisierung von Bildern mit hoher Qualität, geringer Latenz oder geringem Energieverbrauch während der Videoaufnahme verwenden soll, oder legt diesen fest.
DigitalWindowControl	Ruft ein DigitalWindowControl-Objekt ab, mit dem Apps einen Unterbereich des Sensors des Aufnahmegeräts erfassen können.
Exposure	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Belichtungszeit der Kamera verwendet werden kann.
ExposureCompensationControl	Ruft das Steuerelement für die Belichtungskorrektur für dieses Videogerät ab.
ExposureControl	Ruft das Belichtungssteuerelement für dieses Videogerät ab.
ExposurePriorityVideoControl	Ruft den ExposurePriorityVideoControl ab, der dem VideoDeviceController zugeordnet ist.
FlashControl	Ruft das Blitzsteuerelement für dieses Videogerät ab.
Focus	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Fokuseinstellung der Kamera verwendet werden kann.
FocusControl	Ruft das Fokussteuerelement für dieses Videogerät ab.
HdrVideoControl	Ruft das hdrVideoControl ab, das dem VideoDeviceController zugeordnet ist. Dadurch können Sie den HDR-Videoaufnahmemodus (High Dynamic Range) auf Geräten aktivieren und deaktivieren, die ihn unterstützen.
Hue	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Farbtoneinstellung der Kamera verwendet werden kann.
Id	Ruft eine Zeichenfolge ab, die den Bezeichner für den Videogerätecontroller enthält.
InfraredTorchControl	Ruft das Infrarot-Taschenlampensteuerelement für das ausgewählte Videogerät ab.
IsoSpeedControl	Ruft die ISO-Filmdrehzahlsteuerung für dieses Videogerät ab.
LowLagPhoto	Ruft das Fotosteuerelement mit geringer Verschlussverzögerung für dieses Videogerät ab.
LowLagPhotoSequence	Ruft das Fotosequenzsteuerelement mit geringer Verschlussverzögerung für dieses Videogerät ab.
OpticalImageStabilizationControl	Ruft das OpticalImageStabilizationControl ab, das dem VideoDeviceController zugeordnet ist.
Pan	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Schwenkeinstellung der Kamera verwendet werden kann.
PanelBasedOptimizationControl	Ruft panelBasedOptimizationControl ab, das es einer App ermöglicht, dem Aufzeichnungsgerätetreiber zu ermöglichen, die Kameraaufnahmefunktion basierend auf der Panelposition der Kamera zu optimieren.
PhotoConfirmationControl	Ruft das Fotobestätigungssteuerelement für dieses Videogerät ab.
PrimaryUse	Ruft die primäre Verwendung für das Gerät ab oder legt diese fest.
RegionsOfInterestControl	Ruft das Regions of Interest-Steuerelement für dieses Videogerät ab.
Roll	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Rolleinstellung der Kamera verwendet werden kann.
SceneModeControl	Ruft das Szenenmodus-Steuerelement für dieses Videogerät ab.
Tilt	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Neigungseinstellung der Kamera verwendet werden kann.
TorchControl	Ruft das Taschenlampensteuerelement für dieses Videogerät ab.
VariablePhotoSequenceController	Ruft den VariablePhotoSequenceController ab, der dem VideoDeviceController zugeordnet ist.
VideoTemporalDenoisingControl	Ruft das VideoTemporalDenoisingControl ab, das dem VideoDeviceController zugeordnet ist. Dadurch können Sie die temporale Denoising aktivieren und deaktivieren, bei der Bilddaten aus angrenzenden Frames verwendet werden, um das Auftreten von Rauschen in aufgezeichneten Videos auf Geräten zu reduzieren, die dies unterstützen.
WhiteBalance	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen des Weißabgleichs auf der Kamera verwendet werden kann.
WhiteBalanceControl	Ruft das Weißabgleichssteuerelement für dieses Videogerät ab.
Zoom	Ruft ein MediaDeviceControl-Objekt ab, das zum Abrufen oder Festlegen der Zoomeinstellung der Kamera verwendet werden kann.
ZoomControl	Ruft das ZoomControl ab, das dem VideoDeviceController zugeordnet ist.

Methoden

GetAvailableMediaStreamProperties(MediaStreamType)	Ruft eine Liste der unterstützten Codierungseigenschaften für das Videogerät ab.
GetDeviceProperty(String)	Ruft den Wert der Eigenschaft mit der angegebenen ID aus dem Erfassungsgerätetreiber ab. Sie können diese Methode verwenden, um Eigenschaften abzufragen, die für eine bestimmte Kamera spezifisch sind.
GetDevicePropertyByExtendedId(Byte[], IReference<UInt32>)	Ruft den Wert der Eigenschaft mit der angegebenen ID aus dem Erfassungsgerätetreiber ab. Dabei wird eine erweiterte ID mit benutzerdefinierten Headerinformationen verwendet und die maximale Puffergröße angegeben, die zum Speichern des Ergebnisses erforderlich ist. Sie können diese Methode verwenden, um Eigenschaften abzufragen, die für eine bestimmte Kamera spezifisch sind.
GetDevicePropertyById(String, IReference<UInt32>)	Ruft den Wert der -Eigenschaft vom Capture-Gerätetreiber mit der ID mit benutzerdefinierten Headerinformationen ab. Sie können diese Methode verwenden, um Eigenschaften abzufragen, die für eine bestimmte Kamera spezifisch sind.
GetMediaStreamProperties(MediaStreamType)	Ruft die Codierungseigenschaften für den angegebenen Medienstreamtyp für das Videogerät ab.
SetDeviceProperty(String, Object)	Legt den Wert der -Eigenschaft mit der angegebenen ID für den Treiber des Erfassungsgeräts fest. Sie können diese Methode verwenden, um Eigenschaften festzulegen, die für eine bestimmte Kamera spezifisch sind.
SetDevicePropertyByExtendedId(Byte[], Byte[])	Legt den Wert der Eigenschaft mit der angegebenen ID des Treibers des Erfassungsgerätes fest, wobei eine erweiterte ID mit benutzerdefinierten Headerinformationen verwendet und der Wert als Bytearray bereitgestellt wird.
SetDevicePropertyById(String, Object)	Legt den Wert der -Eigenschaft mit der angegebenen ID aus dem Treiber des Erfassungsgeräts fest, wobei eine erweiterte ID mit benutzerdefinierten Headerinformationen verwendet und der Wert als Objekt bereitgestellt wird.
SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)	Legt die Codierungseigenschaften für den angegebenen Mediendatenstromtyp für das Videogerät asynchron fest.
TryAcquireExclusiveControl(String, MediaCaptureDeviceExclusiveControlReleaseMode)	Fordert die exklusive Steuerung der Kamera mit der angegebenen Geräte-ID an.
TryGetPowerlineFrequency(PowerlineFrequency)	Ruft die lokale Netzleitungshäufigkeit ab.
TrySetPowerlineFrequency(PowerlineFrequency)	Legt die lokale Netzleitungshäufigkeit fest.

Weitere Informationen

• Beispiel für ein Lampengerät