Méthode IMediaDet::WriteBitmapBits

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 WriteBitmapBits méthode récupère une image vidéo à l’heure du média spécifiée et l’écrit dans un fichier. La trame vidéo est toujours au format RVB 24 bits.

Syntaxe

HRESULT WriteBitmapBits(
   double StreamTime,
   long   Width,
   long   Height,
   BSTR   Filename
);

Paramètres

StreamTime

Heure à laquelle récupérer l’image vidéo.

Width

Largeur de l’image, en pixels.

Height

Hauteur de l’image, en pixels.

Nom du fichier

Chemin du fichier dans lequel enregistrer la bitmap. Si le fichier existe déjà, cette méthode le remplace.

Valeur renvoyée

Retourne S_OK réussi. Sinon, retourne une valeur HRESULT qui indique la cause de l’erreur. Les codes d’erreur possibles sont les suivants :

Notes

Avant d’appeler cette méthode, définissez le nom de fichier et le flux en appelant IMediaDet::p ut_Filename et IMediaDet::p ut_CurrentStream.

Cette méthode place le détecteur de média en mode de saisie bitmap. Une fois cette méthode appelée, les différentes méthodes d’informations de flux dans IMediaDet ne fonctionnent pas, sauf si vous créez une nouvelle instance du détecteur de média.

Configuration requise

Voir aussi

IMediaDet, interface

Codes d’erreur et de réussite