ICaptureGraphBuilder ::CopyCaptureFile, méthode (strmif.h)

Article
02/21/2025

[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.]

NoteL’interface ICaptureGraphBuilder est déconseillée. Utilisez plutôt ICaptureGraphBuilder2 .

Copie les données multimédias valides à partir du fichier de capture préalloué.

Syntaxe

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

Paramètres

[in] lpwstrOld

Pointeur vers une chaîne Unicode™ contenant le nom du fichier source.

[in] lpwstrNew

Pointeur vers une chaîne Unicode contenant le nom du fichier de destination. Les données valides sont copiées dans ce fichier.

[in] fAllowEscAbort

Valeur indiquant si le fait d’appuyer sur la touche Échap annule l’opération de copie. TRUE indique qu’il le fera ; FALSE indique que cette méthode ignore cette frappe.

[in] pCallback

Le pointeur facultatif vers un IAMCopyCaptureFileProgress indique la progression (pourcentage terminé) de l’opération de copie.

Valeur retournée

Retourne une valeur HRESULT .

Remarques

Le nouveau fichier contiendra uniquement des données valides et peut donc être beaucoup plus court que le fichier source. En règle générale, vous capturez toujours dans le même énorme fichier préalloué et utilisez cette méthode pour copier les données que vous souhaitez enregistrer de chaque capture vers un nouveau fichier.

Si vous spécifiez pCallback, la méthode Progress de l’interface IAMCopyCaptureFileProgress sera appelée régulièrement avec un entier compris entre 0 et 100 représentant le pourcentage terminé.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)

Voir aussi

Codes d’erreur et de réussite

ICaptureGraphBuilder, interface

Partager via