Méthode IVideoWindow ::p ut_BackgroundPalette (control.h)

  • Article

[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 put_BackgroundPalette méthode spécifie si la fenêtre vidéo réalise sa palette en arrière-plan.

Syntaxe

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Paramètres

[in] BackgroundPalette

Spécifie si le convertisseur vidéo réalise sa palette en arrière-plan. Il doit s’agir de l’une des valeurs suivantes :

Valeur Description
OATRUE Le convertisseur vidéo réalise la palette en arrière-plan.
OAFALSE Le convertisseur vidéo ne réalise pas la palette en arrière-plan. (valeur par défaut).

Valeur retournée

Les valeurs de retour possibles sont les suivantes :

Code de retour Description
E_INVALIDARG
 Argument non valide.
S_OK
 Réussite.
VFW_E_NOT_CONNECTED
 Le filtre du convertisseur vidéo n’est pas connecté.

Remarques

Si BackgroundPalette est OATRUE et que l’image vidéo nécessite une palette, le convertisseur vidéo se rend compte de cette palette en arrière-plan. Toutes les couleurs utilisées par la palette changent pour leur correspondance la plus proche dans la palette d’affichage avant le dessin. Cela garantit qu’une application n’aura pas sa palette perturbée. Toutefois, il impose des pénalités de performances sévères à la vidéo.

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 control.h (include Dshow.h)
Bibliothèque Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IVideoWindow, interface

IVideoWindow ::get_BackgroundPalette