Méthode IOverlay::SetPalette (strmif.h)

Article
07/28/2023

[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 SetPalette méthode définit la palette.

Syntaxe

HRESULT SetPalette(
  [in] DWORD        dwColors,
  [in] PALETTEENTRY *pPalette
);

Paramètres

[in] dwColors

Nombre de couleurs présentes.

[in] pPalette

Pointeur vers les couleurs à utiliser pour la palette.

Valeur renvoyée

Retourne S_OK en cas de réussite. Si la méthode échoue, elle retourne un code d’erreur HRESULT .

Notes

Cette méthode définit une palette logique pour la fenêtre. Il n’est pas garanti que la fenêtre ait toujours les couleurs demandées dans la palette d’appareils système réelle. Le système d’exploitation Microsoft® Windows® garantit uniquement ces couleurs lorsque la fenêtre est la fenêtre active de premier plan. La palette d’appareils actuelle peut être obtenue en appelant IOverlay::GetPalette.

Si l’appareil n’a pas de palette, il retourne VFW_E_NO_DISPLAY_PALETTE.

Le filtre Mélangeur de superposition retourne E_NOTIMPL.

Configuration requise


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

IOverlay Interface

Share via