Méthode IOverlay::SetPalette (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 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 |