MediaCaptureInitializationSettings.VideoProfile Eigenschaft

Definition

Namespace:

Windows.Media.Capture

Ruft das Videoprofil ab, das Dem Treiber Hinweise zur Optimierung für unterschiedliche Aufnahmeszenarien bietet, oder legt es fest.

public:
 property MediaCaptureVideoProfile ^ VideoProfile { MediaCaptureVideoProfile ^ get(); void set(MediaCaptureVideoProfile ^ value); };

MediaCaptureVideoProfile VideoProfile();

void VideoProfile(MediaCaptureVideoProfile value);

public MediaCaptureVideoProfile VideoProfile { get; set; }

var mediaCaptureVideoProfile = mediaCaptureInitializationSettings.videoProfile;
mediaCaptureInitializationSettings.videoProfile = mediaCaptureVideoProfile;

Public Property VideoProfile As MediaCaptureVideoProfile

Eigenschaftswert

MediaCaptureVideoProfile

Das Videoprofil.

Windows-Anforderungen

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. die Aufnahme von qualitativ hochwertigen Fotos während der Videoaufzeichnung 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. Weitere Informationen zu Videoprofilen finden Sie unter MediaCaptureVideoProfile.

Der Wert, den Sie für diese Eigenschaft verwenden, bestimmt, wie das System die Werte für andere Eigenschaften von MediaCaptureInitializationSettings verarbeitet.

• Wenn Sie VideoProfile auf ein gültiges MediaCaptureVideoProfile-Objekt festlegen, verwendet das System die dem Profil zugeordneten Treiberhinweise und verwendet die Medienbeschreibungswerte, die Sie für die Eigenschaften PhotoMediaDescription, PreviewMediaDescription und RecordMediaDescription angeben.
• Wenn Sie VideoProfile auf ein gültiges MediaCaptureVideoProfile-Objekt festlegen und weder die Eigenschaften PhotoMediaDescription, PreviewMediaDescription oder RecordMediaDescription festlegen, verwendet das System die Treiberhinweise, die dem Profil zugeordnet sind, und verwendet den ersten Eintrag (0 Index) im SupportedPhotoMediaDescription, SupportedPreviewMediaDescription und SupportedRecordMediaDescription des Profils. listet als Medienbeschreibung für die jeweiligen Eigenschaften auf.
• Wenn der Wert von VideoProfile überhaupt nicht festgelegt ist, ignoriert das System den Wert von PhotoMediaDescription, PreviewMediaDescription und RecordMediaDescription und wird zum Legacyverhalten zurückgesetzt, bevor die Videoprofil-APIs eingeführt wurden.

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 zur Verwendung von Videoprofilen finden Sie unter Ermitteln und Auswählen von Kamerafunktionen mit Kameraprofilen.