Méthode IMediaDet::GetSampleGrabber

[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 GetSampleGrabber méthode récupère un pointeur vers l’interface ISampleGrabber , qui permet à une application de récupérer des exemples individuels à partir d’un flux multimédia.

Syntaxe

HRESULT GetSampleGrabber(
  [out] ISampleGrabber **ppVal
);

Paramètres

ppVal [out]

Reçoit un pointeur vers l’interface ISampleGrabber .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Appelez IMediaDet::EnterBitmapGrabMode avant d’appeler cette méthode. L’interface ISampleGrabber vous permet de récupérer des exemples multimédias individuels à partir du flux. Si vous avez simplement besoin d’une bitmap à partir d’une trame vidéo, appelez plutôt la méthode IMediaDet::GetBitmapBits . L’interface ISampleGrabber est plus flexible, mais nécessite davantage de travail de la part de l’application.

Si cette méthode réussit, l’interface ISampleGrabber qu’elle retourne a un nombre de références en suspens. Veillez à libérer l’interface lorsque vous avez terminé de l’utiliser.

Configuration requise

Voir aussi

IMediaDet Interface

Codes d’erreur et de réussite