Freigeben über

MediaCaptureVideoProfile Klasse

  • Referenz

Definition

Namespace:
Windows.Media.Capture
Bearbeiten

Stellt ein Videoprofil dar, das eine vom Videoaufnahmegerät unterstützte Konfiguration angibt.

public ref class MediaCaptureVideoProfile sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaCaptureVideoProfile final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
Vererbung
Object Platform::Object IInspectable MediaCaptureVideoProfile
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

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

Hinweise

Videoprofile bieten eine einfache Möglichkeit, das Videoaufnahmegerät mit einer Gruppe von Einstellungen zu konfigurieren, die garantiert mit einem bestimmten Aufnahmegerät funktionieren und für Ihr gewünschtes Aufnahmeszenario optimiert sind. Es gibt eine Reihe bekannter Videoprofile, die das System für gängige Szenarien bereitstellt, z. B. das Erfassen von qualitativ hochwertigen Fotos oder Videos, das Aufzeichnen einer Fotosequenz oder Videokonferenzen. Verwenden Sie MediaCapture.FindKnownVideoProfiles, um eine Liste der bekannten Videoprofile für ein bestimmtes Videogerät abzurufen. Einige Hardwarehersteller können andere Videoprofile verfügbar machen, die Sie abrufen können, indem Sie MediaCapture.FindAllVideoProfiles aufrufen.

Ein Videoprofil macht drei Listen von MediaCaptureVideoProfileMediaDescription-Objekten verfügbar: SupportedPhotoMediaDescription, SupportedPreviewMediaDescription und SupportedRecordMediaDescription. Jedes Element in diesen Listen ist eine Gruppe von Einstellungen, die für den entsprechenden Vorgang unterstützt werden. Beispielsweise kann ein einzelnes Videoprofil das Aufzeichnen von 720p-Videos mit 30 fps mit HDR-Videounterstützung unterstützen und auch die Aufnahme von 1080p-Videos mit 30 fps ohne HDR-Videounterstützung unterstützen. In diesem Fall wird jede dieser Objekte durch ein MediaCaptureVideoProfileMediaDescription-Objekt in der Liste SupportedRecordMediaDescription des Videoprofils dargestellt.

Sie konfigurieren das Erfassungsgerät für die Verwendung eines bestimmten Videoprofils mithilfe des MediaCaptureInitializationSettings-Objekts . Es ist wichtig, dass das Videoprofil, das Sie beim Konfigurieren des Geräts verwenden, mit den anderen Initialisierungseinstellungen kompatibel ist. Weitere Informationen zur ordnungsgemäßen Verwendung von Medienprofilbeschreibungen in MediaCaptureInitializationSettings finden Sie unter MediaCaptureInitializationSettings.VideoProfile.

Bevor Sie Videoprofile verwenden, sollten Sie den von MediaCapture.IsVideoProfileSupported zurückgegebenen Wert überprüfen, um sicherzustellen, dass Videoprofile vom Aufnahmegerät unterstützt werden.

Anleitungen zum Arbeiten mit Videoprofilen finden Sie unter Ermitteln und Auswählen von Kamerafunktionen mit Kameraprofilen.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1803 17134 FrameSourceInfos
1803 17134 Eigenschaften

Eigenschaften

FrameSourceInfos

Ruft eine schreibgeschützte Liste von MediaFrameSourceInfo-Objekten ab, die Details zu den Funktionen einer MediaFrameSource bereitstellen.
Id

Ruft den eindeutigen Bezeichner des Videoprofils ab.
Properties

Ruft eine schreibgeschützte Zuordnung benutzerdefinierter Attribute ab, die vom Hersteller des Erfassungsgeräts bereitgestellt werden.
SupportedPhotoMediaDescription

Ruft eine Liste der MediaCaptureVideoProfileMediaDescription-Objekte ab, die unterstützte Videogeräteeinstellungen für die Fotoaufnahme darstellen.
SupportedPreviewMediaDescription

Ruft eine Liste der MediaCaptureVideoProfileMediaDescription-Objekte ab, die unterstützte Videogeräteeinstellungen für die Videovorschau darstellen.
SupportedRecordMediaDescription

Ruft eine Liste der MediaCaptureVideoProfileMediaDescription-Objekte ab, die unterstützte Videogeräteeinstellungen für die Videoaufzeichnung darstellen.
VideoDeviceId

Ruft die Geräte-ID des Videogeräts ab, das dem Videoprofil zugeordnet ist.

Methoden

GetConcurrency()

Ruft die Liste der MediaCaptureVideoProfile-Objekte ab, die gleichzeitig mit diesem Videoprofil verwendet werden können.

Gilt für:

Weitere Informationen