Exemple de filtre d’accrochage

Notes

[Déconseillé. Cette API peut être supprimée des futures versions de Windows.]

L’exemple de filtre d’accrochage permet de récupérer des exemples au fur et à mesure qu’ils passent par le graphique de filtre. Il s’agit d’un filtre de transformation avec une broche d’entrée et une broche de sortie. Il passe tous les exemples en aval inchangés, de sorte que vous pouvez l’insérer dans un graphique de filtre sans modifier le flux de données. Votre application peut ensuite récupérer des échantillons individuels à partir du filtre en appelant des méthodes sur l’interface ISampleGrabber .

Si vous souhaitez récupérer des exemples sans restituer les données, connectez le filtre d’accroche d’échantillon au filtre de convertisseur null .

Étiquette Valeur
Interfaces de filtre IBaseFilter, ISampleGrabber
Types de média de broche d’entrée Tout type de média.
Interfaces pin d’entrée IMemInputPin, IPIN, IQualityControl
Types de média de broche de sortie Tout type de média. Correspond au type de média d’entrée.
Interfaces de broche de sortie IMediaPosition, IMediaSeeking, IPIN, IQualityControl
CLSID du filtre CLSID _ SampleGrabber
CLSID de page de propriétés Aucune page de propriétés.
Exécutable Qedit.dll
Mérite MÉRITE _ n' _ _ utilise pas
Catégorie de filtre CLSID _ LegacyAmFilterCategory

Remarques

Pour utiliser ce filtre, ajoutez-le au graphique de filtre et appelez ISampleGrabber :: SetMediaType avec le type de média souhaité. Cette méthode spécifie le type de média pour les connexions de broche d’entrée et de sortie du filtre. Connectez ensuite le filtre à d’autres filtres dans le graphique.

Si vous appelez ISampleGrabber :: SetBufferSamples avec la valeur true, le filtre met en mémoire tampon chaque échantillon qu’il reçoit avant de le passer en aval. Appelez la méthode ISampleGrabber :: GetCurrentBuffer pour récupérer le contenu actuel de la mémoire tampon. Vous pouvez également appeler ISampleGrabber :: SetCallback pour que le filtre appelle une fonction de rappel chaque fois qu’il reçoit un exemple.

Le filtre présente les limitations suivantes pour les formats vidéo :

  • Il ne prend pas en charge les types vidéo avec une orientation verticale ( bihauteur négative).
  • Elle ne prend pas en charge la structure de format VIDEOINFOHEADER2 (type de format égal au format _ VideoInfo2).
  • Elle rejette tout type de vidéo dans lequel le Stride de la surface ne correspond pas à la largeur de la vidéo.

Par conséquent, la accroche d’échantillon ne se connecte pas au convertisseur de mixage vidéo (VMR) pour certains types de vidéo.

Configuration requise

Condition requise Valeur
En-tête
Qedit. h

Voir aussi

DirectShow Modification des objets de services

Utilisation de l’exemple d’accrochage