MediaCapture.GetPreviewFrameAsync Methode

  • Referenz

Definition

Namespace:
Windows.Media.Capture

Ü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()

Bearbeiten

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

IAsyncOperation<VideoFrame>

Ein asynchroner Vorgang, der bei erfolgreicher Fertigstellung einen VideoFrame zurückgibt.

Attribute
OverloadAttribute RemoteAsyncAttribute

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)

Bearbeiten

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

IAsyncOperation<VideoFrame>

Ein asynchroner Vorgang, der bei erfolgreicher Fertigstellung einen VideoFrame zurückgibt.

Attribute
OverloadAttribute RemoteAsyncAttribute

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.

Weitere Informationen

Gilt für: