IOverlay::SetPalette-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die SetPalette -Methode legt die Palette fest.
Syntax
HRESULT SetPalette(
[in] DWORD dwColors,
[in] PALETTEENTRY *pPalette
);
Parameter
[in] dwColors
Anzahl der vorhandenen Farben.
[in] pPalette
Zeiger auf Farben, die für die Palette verwendet werden sollen.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Fehlercode zurück.
Bemerkungen
Diese Methode legt eine logische Palette für das Fenster fest. Es ist nicht garantiert, dass das Fenster immer über die angeforderten Farben in der tatsächlichen Systemgerätepalette verfügt. Das Microsoft® Windows-Betriebssystem® garantiert diese Farben nur, wenn das Fenster das aktive Fenster im Vordergrund ist. Die aktuelle Gerätepalette kann abgerufen werden, indem Sie IOverlay::GetPalette aufrufen.
Wenn das Gerät über keine Palette verfügt, wird VFW_E_NO_DISPLAY_PALETTE zurückgegeben.
Der Filter Overlay Mixer gibt E_NOTIMPL zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |