Méthode CImagePalette.PreparePalette

[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 PreparePalette méthode configure une palette, basée sur un type de média du filtre propriétaire.

Syntaxe

HRESULT PreparePalette(
   const CMediaType *pmtNew,
   const CMediaType *pmtOld,
         LPSTR      szDevice
);

Paramètres

pmtNew

Pointeur vers le nouveau type de média. Le bloc de format doit être une structure VIDEOINFOHEADER .

pmtOld

Pointeur vers l’ancien type de média. Si le type de média est défini pour la première fois, ce paramètre peut être un type vide sans bloc de format. Sinon, le bloc de format doit être une structure VIDEOINFOHEADER .

szDevice

Pointeur vers une chaîne qui contient le nom du périphérique d’affichage, tel que retourné par la fonction GDI EnumDisplayDevices . Pour utiliser le périphérique d’affichage main, définissez ce paramètre sur NULL.

Valeur renvoyée

Retourne S_OK si la palette a été mise à jour, ou S_FALSE si la palette n’a pas changé.

Notes

Si la palette doit être mise à jour, cette méthode effectue les actions suivantes :

• Appelle CImagePalette::MakePalette pour créer une palette logique.
• Envoie un événement EC_PALETTE_CHANGED au Gestionnaire de graphe de filtres.
• Appelle CBaseWindow::SetPalette sur l’objet CBaseWindow .
• Appelle CDrawImage::IncrementPaletteVersion sur l’objet CDrawImage .

Configuration requise

Voir aussi

CImagePalette, classe