Partager via


IVMRDeinterlaceControl::SetDeinterlaceMode, méthode (strmif.h)

[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 méthode SetDeinterlaceMode définit le mode de désinterlacation pour le flux vidéo spécifié.

Syntaxe

HRESULT SetDeinterlaceMode(
  [in] DWORD  dwStreamID,
  [in] LPGUID lpDeinterlaceMode
);

Paramètres

[in] dwStreamID

Index du flux vidéo à définir. Pour définir tous les flux, utilisez la valeur 0xFFFFFFFF.

[in] lpDeinterlaceMode

Pointeur vers un GUID qui spécifie le mode de désentlacement. Pour désactiver le désentlacement, utilisez la valeur GUID_NULL.

Valeur renvoyée

Retourne une valeur HRESULT . Il peut prendre les valeurs suivantes :

Code de retour Description
E_INVALIDARG
Numéro de flux non valide.
E_POINTER
Argument pointeur NULL .
S_OK
Opération réussie.
VFW_E_VMR_NOT_IN_MIXER_MODE
Le VMR n’est pas en mode mélangeur.

Notes

Si l’application ne spécifie pas le mode, le vmR utilise par défaut le premier mode signalé par le pilote. Dans les deux cas, si le VMR ne peut pas utiliser le mode préféré, il revient à un autre mode comme spécifié dans la méthode IVMRDeinterlaceControl::SetDeinterlacePrefs .

La méthode SetDeinterlaceMode n’est efficace que pour les nouvelles connexions effectuées au VMR. Certains modes de désentlacement nécessitent des exemples de référence supplémentaires ; le nombre exact dépend du mode. Le VMR alloue des surfaces pour ces exemples supplémentaires. Le client doit définir le mode désentlacé avant que les surfaces aient été allouées. L’allocation de surface se produit après l’un des éléments suivants :

  • Connexions pin, y compris les reconnexions dynamiques
  • Modifications de format dynamique (le filtre amont appelle IPin::ReceiveConnection pour spécifier un nouveau format)
  • Modifications de résolution
  • Superviser les changements

Configuration requise

   
Client minimal pris en charge Windows XP avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [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

IVMRDeinterlaceControl Interface

IVMRDeinterlaceControl::GetDeinterlaceMode

Utilisation du convertisseur de mixage vidéo