MediaCapture.InitializeAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| InitializeAsync() |
Initialisiert das MediaCapture-Objekt unter Verwendung der Standardeinstellungen. |
| InitializeAsync(MediaCaptureInitializationSettings) |
Initialisiert das MediaCapture-Objekt . |
InitializeAsync()
Initialisiert das MediaCapture-Objekt unter Verwendung der Standardeinstellungen.
public:
virtual IAsyncAction ^ InitializeAsync() = InitializeAsync;/// [Windows.Foundation.Metadata.Overload("InitializeAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction InitializeAsync();[Windows.Foundation.Metadata.Overload("InitializeAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction InitializeAsync();function initializeAsync()Public Function InitializeAsync () As IAsyncActionGibt zurück
Gibt ein IAsyncAction-Objekt zurück, das zum Steuern des asynchronen Vorgangs verwendet wird.
- Attribute
Windows-Anforderungen
| App-Funktionen |
backgroundMediaRecording
microphone
webcam
|
Hinweise
InitializeAsync startet eine Zustimmungsaufforderung, um die Berechtigung des Benutzers für die App für den Zugriff auf das Mikrofon oder die Kamera zu erhalten. InitializeAsync sollte über den Standard UI-Thread Ihrer App aufgerufen werden. In Apps, die C# oder C++ verwenden, sollte die erste Verwendung des MediaCapture-Objekts zum Aufrufen von InitializeAsync im STA-Thread erfolgen. Aufrufe aus einem MTA-Thread können zu undefiniertem Verhalten führen.
Anleitungen zum Initialisieren und Herunterfahren des MediaCapture-Objekts finden Sie unter Grundlegende Foto-, Video- und Audioaufnahme mit MediaCapture.
Ab Windows, Version 1803, gibt InitializeAsync einen Fehler zurück oder löst eine Ausnahme mit dem Fehlercode 0xC00DAFC8 (MF_E_UNSUPPORTED_CAPTURE_DEVICE_PRESENT) aus, wenn ein nicht unterstütztes Erfassungsgerät erkannt wird. Sie können diesen Fehlercode überprüfen und ihre Benutzeroberfläche aktualisieren, um eine Warnung für den Benutzer zu erhalten.
Weitere Informationen
- InitializeAsync(MediaCaptureInitializationSettings)
- Allgemeine Foto-, Video- und Audioaufnahme mit „MediaCapture“
Gilt für:
InitializeAsync(MediaCaptureInitializationSettings)
Initialisiert das MediaCapture-Objekt .
public:
virtual IAsyncAction ^ InitializeAsync(MediaCaptureInitializationSettings ^ mediaCaptureInitializationSettings) = InitializeAsync;/// [Windows.Foundation.Metadata.Overload("InitializeWithSettingsAsync")]
IAsyncAction InitializeAsync(MediaCaptureInitializationSettings const& mediaCaptureInitializationSettings);[Windows.Foundation.Metadata.Overload("InitializeWithSettingsAsync")]
public IAsyncAction InitializeAsync(MediaCaptureInitializationSettings mediaCaptureInitializationSettings);function initializeAsync(mediaCaptureInitializationSettings)Public Function InitializeAsync (mediaCaptureInitializationSettings As MediaCaptureInitializationSettings) As IAsyncActionParameter
- mediaCaptureInitializationSettings
- MediaCaptureInitializationSettings
Die Initialisierungseinstellungen.
Gibt zurück
Gibt ein IAsyncAction-Objekt zurück, das zum Steuern des asynchronen Vorgangs verwendet wird.
- Attribute
Windows-Anforderungen
| App-Funktionen |
backgroundMediaRecording
microphone
webcam
|
Hinweise
InitializeAsync startet eine Zustimmungsaufforderung, um die Berechtigung des Benutzers für die App für den Zugriff auf das Mikrofon oder die Kamera zu erhalten. InitializeAsync sollte über den Standard UI-Thread Ihrer App aufgerufen werden. In Apps, die C# oder C++ verwenden, sollte die erste Verwendung des MediaCapture-Objekts zum Aufrufen von InitializeAsync im STA-Thread erfolgen. Aufrufe aus einem MTA-Thread können zu undefiniertem Verhalten führen.
Anleitungen zum Initialisieren und Herunterfahren des MediaCapture-Objekts finden Sie unter Grundlegende Foto-, Video- und Audioaufnahme mit MediaCapture.
Ab Windows, Version 1803, gibt InitializeAsync einen Fehler zurück oder löst eine Ausnahme mit dem Fehlercode 0xC00DAFC8 (MF_E_UNSUPPORTED_CAPTURE_DEVICE_PRESENT) aus, wenn ein nicht unterstütztes Erfassungsgerät erkannt wird. Sie können diesen Fehlercode überprüfen und ihre Benutzeroberfläche aktualisieren, um eine Warnung für den Benutzer zu erhalten.