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.]
Notes
[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]
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 :
| Code de retour | Description |
|---|---|
|
Impossible d’ajouter le filtre Sample Grabber au graphique. |
|
Échec. |
|
Mémoire insuffisante. |
|
Erreur inattendue. |
|
Impossible de remplacer le fichier. |
|
Type de média non valide. |
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.
Remarque
Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.
Remarque
Pour obtenir Qedit.h, téléchargez Microsoft Windows SDK Update pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi