MediaCapture.GetPreviewFrameAsync 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
| GetPreviewFrameAsync() |
Ruft einen Vorschaurahmen vom Aufnahmegerät ab. |
| GetPreviewFrameAsync(VideoFrame) |
Ruft einen Vorschaurahmen vom Aufnahmegerät ab, der in das bereitgestellte Zielvideoframe kopiert und in das Format des Zielframes konvertiert wird. |
GetPreviewFrameAsync()
Ruft einen Vorschaurahmen vom Aufnahmegerät ab.
public:
virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync() = GetPreviewFrameAsync;/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync();[Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync();function getPreviewFrameAsync()Public Function GetPreviewFrameAsync () As IAsyncOperation(Of VideoFrame)Gibt zurück
Ein asynchroner Vorgang, der bei erfolgreicher Fertigstellung einen VideoFrame zurückgibt.
- Attribute
Windows-Anforderungen
| App-Funktionen |
backgroundMediaRecording
|
Hinweise
Diese Methode gibt den Vorschaurahmen im aktuellen Format des Aufnahmegeräts zurück, ohne den Frame zu kopieren oder zu konvertieren. Um den Vorschaurahmen in einem anderen Format abzurufen, verwenden Sie die GetPreviewFrameAsync(VideoFrame)- Überladung, und übergeben Sie einen VideoFrame mit dem gewünschten Format.
Anleitungen zu Vorschauframes finden Sie unter Abrufen eines Vorschaurahmens.
Hinweis
Für App-Szenarien, in denen eine große Anzahl von Frames in einer Sequenz erfasst werden soll, z. B. Szenarien für maschinelles Sehen, wird empfohlen, die MediaFrameReader-Klasse anstelle von GetPreviewFrameAsync zu verwenden. Weitere Informationen und Anleitungen finden Sie unter Verarbeiten von Medienframes mit MediaFrameReader.
Weitere Informationen
Gilt für:
GetPreviewFrameAsync(VideoFrame)
Ruft einen Vorschaurahmen vom Aufnahmegerät ab, der in das bereitgestellte Zielvideoframe kopiert und in das Format des Zielframes konvertiert wird.
public:
virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync(VideoFrame ^ destination) = GetPreviewFrameAsync;/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame const& destination);[Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame destination);function getPreviewFrameAsync(destination)Public Function GetPreviewFrameAsync (destination As VideoFrame) As IAsyncOperation(Of VideoFrame)Parameter
- destination
- VideoFrame
Der Videoframe, in den der Vorschaurahmen kopiert wird.
Gibt zurück
Ein asynchroner Vorgang, der bei erfolgreicher Fertigstellung einen VideoFrame zurückgibt.
- Attribute
Windows-Anforderungen
| App-Funktionen |
backgroundMediaRecording
|
Hinweise
Um einen Vorschaurahmen zu erhalten, ohne einen Kopier- oder Konvertierungsvorgang durchzuführen, verwenden Sie die Überladung ohne Argument von GetPreviewFrameAsync.
Anleitungen zu Vorschauframes finden Sie unter Abrufen eines Vorschaurahmens.
Hinweis
Für App-Szenarien, in denen eine große Anzahl von Frames in einer Sequenz erfasst werden soll, z. B. Szenarien für maschinelles Sehen, wird empfohlen, die MediaFrameReader-Klasse anstelle von GetPreviewFrameAsync zu verwenden. Weitere Informationen und Anleitungen finden Sie unter Verarbeiten von Medienframes mit MediaFrameReader.