MediaCapture.GetPreviewFrameAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| GetPreviewFrameAsync() |
Obtient une image d’aperçu de l’appareil de capture. |
| GetPreviewFrameAsync(VideoFrame) |
Obtient une image d’aperçu de l’appareil de capture, copiée dans le VideoFrame de destination fourni et convertie au format de l’image de destination. |
GetPreviewFrameAsync()
Obtient une image d’aperçu de l’appareil de capture.
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)Retours
Opération asynchrone qui retourne un VideoFrame en cas de réussite de l’exécution.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
backgroundMediaRecording
|
Remarques
Cette méthode retourne l’image d’aperçu au format actuel de l’appareil de capture sans copier ou convertir le frame. Pour obtenir l’image d’aperçu dans un autre format, utilisez la surcharge GetPreviewFrameAsync(VideoFrame) et transmettez un VideoFrame au format souhaité.
Pour obtenir des conseils pratiques sur les images d’aperçu, consultez Obtenir une image d’aperçu.
Notes
Pour les scénarios d’application qui appellent à capturer un grand nombre d’images dans une séquence, comme les scénarios de vision par ordinateur, il est recommandé d’utiliser la classe MediaFrameReader au lieu de GetPreviewFrameAsync. Pour plus d’informations et pour obtenir des conseils pratiques, consultez Traiter des trames multimédias avec MediaFrameReader.
Voir aussi
S’applique à
GetPreviewFrameAsync(VideoFrame)
Obtient une image d’aperçu de l’appareil de capture, copiée dans le VideoFrame de destination fourni et convertie au format de l’image de destination.
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)Paramètres
- destination
- VideoFrame
Image vidéo dans laquelle la trame d’aperçu sera copiée.
Retours
Opération asynchrone qui retourne un VideoFrame en cas de réussite de l’exécution.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
backgroundMediaRecording
|
Remarques
Pour obtenir un frame d’aperçu sans passer par une opération de copie ou de conversion, utilisez la surcharge sans argument de GetPreviewFrameAsync.
Pour obtenir des conseils pratiques sur les images d’aperçu, consultez Obtenir une image d’aperçu.
Notes
Pour les scénarios d’application qui appellent à capturer un grand nombre d’images dans une séquence, comme les scénarios de vision par ordinateur, il est recommandé d’utiliser la classe MediaFrameReader au lieu de GetPreviewFrameAsync. Pour plus d’informations et pour obtenir des conseils pratiques, consultez Traiter des trames multimédias avec MediaFrameReader.