Méthode CBaseControlVideo.GetVideoPaletteEntries

  • 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 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 GetVideoPaletteEntries méthode récupère une plage d’entrées de palette pour la vidéo.

Syntaxe

HRESULT GetVideoPaletteEntries(
   long StartIndex,
   long Entries,
   long *pRetrieved,
   long *pPalette
);

Paramètres

Startindex

Entrée de palette de démarrage de base zéro.

Entrées

Nombre d’entrées requises.

pRetrieved

Pointeur vers le nombre de couleurs obtenues.

pPalette

Pointeur vers la mémoire tampon de sortie pour les couleurs.

Valeur renvoyée

Retourne NOERROR en cas de réussite, VFW_E_NO_PALETTE_AVAILABLE si les exemples vidéo n’ont pas de palette de couleurs, E_OUTOFMEMORY s’il n’y a pas suffisamment de mémoire disponible, E_INVALIDARG si StartIndex n’est pas valide ou S_FALSE si la palette ne contient pas de couleurs.

Notes

Cette fonction membre retourne la palette actuelle de la vidéo sous la forme d’un tableau alloué par l’utilisateur. Pour rester cohérent, utilisez les membres de la structure Win32 PALETTEENTRY pour retourner les couleurs, plutôt que les membres de la structure RGBQUAD (bien que le paramètre soit long). La mémoire est allouée par l’appelant. Il suffit donc de copier chacun à son tour. Déterminez que le nombre d’entrées demandées et le décalage de la position de début sont valides. Si le nombre d’entrées est égal à zéro, retournez un code S_FALSE.

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBaseControlVideo, classe