IDDrawExclModeVideo ::SetCallbackInterface, méthode (strmif.h)

Article
03/04/2024

[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 SetCallbackInterface méthode récupère un pointeur vers l’interface de rappel de Overlay Mixer afin que l’application appelante puisse être avertie des ajustements apportés à l’affichage pendant la lecture vidéo.

Syntaxe

HRESULT SetCallbackInterface(
  [out] IDDrawExclModeVideoCallback *pCallback,
  [in]  DWORD                       dwFlags
);

Paramètres

[out] pCallback

Pointeur vers l’objet qui implémente l’interface IDDrawExclModeVideoCallback . Si pCallback a la valeur NULL, l’interface de rappel est définie sur NULL et aucun rappel n’est effectué. S’il existait une interface de rappel précédente, elle est publiée et aucun rappel n’y est effectué. Si pCallback n’a pas la valeur NULL et que cette méthode retourne S_OK, le nombre de références de l’objet pCallback pointe vers est incrémenté.

[in] dwFlags

Doit être zéro.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	L’argument n’est pas valide.

Remarques

Une application doit utiliser cette méthode pour recevoir une notification sur la modification de la taille de superposition, de la position ou de la clé de couleur qui se produit, afin qu’elle puisse masquer ou afficher la vidéo, ou ajuster la vidéo au début, à la fin ou pendant la lecture. En appelant cette méthode, une application peut accéder à l’interface IDDrawExclModeVideoCallback et passer le pointeur vers cette interface à overlay Mixer.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IDDrawExclModeVideo, interface

Partager via