Freigeben über


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

Siehe auch

Fehler- und Erfolgscodes

IOverlay-Schnittstelle