Méthode ICaptureGraphBuilder2::CopyCaptureFile (strmif.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La CopyCaptureFile méthode copie les données multimédias valides à partir d’un fichier de capture.

Syntaxe

HRESULT CopyCaptureFile(
  [in] LPOLESTR                   lpwstrOld,
  [in] LPOLESTR                   lpwstrNew,
  [in] int                        fAllowEscAbort,
  [in] IAMCopyCaptureFileProgress *pCallback
);

Paramètres

[in] lpwstrOld

Pointeur vers une chaîne à caractères larges qui contient le nom du fichier source.

[in] lpwstrNew

Pointeur vers une chaîne à caractères larges qui contient le nom du fichier de destination. Les données valides sont copiées dans ce fichier.

[in] fAllowEscAbort

Valeur booléenne qui spécifie si le fait d’appuyer sur la touche ÉCHAP annule l’opération de copie. Si la valeur est TRUE et que l’utilisateur appuie sur la touche Échap, l’opération s’arrête. Si la valeur est FALSE, la méthode ignore la clé ÉCHAP.

[in] pCallback

Pointeur vers une interface IAMCopyCaptureFileProgress pour afficher les informations de progression, ou NULL. Pour plus d'informations, consultez la section Notes.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_FALSE	L’utilisateur a annulé l’opération avant qu’elle ne se termine.
S_OK	Opération réussie.
E_FAIL	Échec.
E_INVALIDARG	Impossible d’ouvrir le fichier source ou le fichier de destination.
E_OUTOFMEMORY	Mémoire insuffisante.
E_POINTER	Argument pointeur NULL .

Notes

En règle générale, vous allez d’abord capturer dans un fichier préalloué volumineux. Cette méthode copie uniquement les données valides dans un nouveau fichier. Par conséquent, le nouveau fichier peut être beaucoup plus petit que le fichier d’origine.

Les fichiers source et de destination doivent être des fichiers AVI. Les autres types de fichiers ne sont pas pris en charge.

Pour afficher la progression de l’opération de copie, implémentez l’interface IAMCopyCaptureFileProgress et passez un pointeur vers l’interface dans le paramètre pCallback . Si pCallback n’a pas la valeur NULL, cette méthode appelle régulièrement la méthode IAMCopyCaptureFileProgress::P rogress avec un entier compris entre 0 et 100 qui spécifie le pourcentage terminé.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

ICaptureGraphBuilder2, interface

Partager via