Freigeben über


VideoDeviceController Klasse

Definition

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
Implementiert

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.

Gilt für:

Weitere Informationen