CBaseControlVideo.GetVideoPaletteEntries-Methode

[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 GetVideoPaletteEntries -Methode ruft einen Bereich von Paletteneinträgen für das Video ab.

Syntax

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

Parameter

Startindex

Nullbasierter Startpaletteneintrag.

Einträge

Anzahl der erforderlichen Einträge.

pRetrieved

Zeiger auf die Anzahl der abgerufenen Farben.

pPalette

Zeiger auf den Ausgabepuffer für Farben.

Rückgabewert

Gibt NOERROR bei erfolgreicher Ausführung zurück, VFW_E_NO_PALETTE_AVAILABLE, wenn die Videobeispiele keine Farbpalette aufweisen, E_OUTOFMEMORY, wenn nicht genügend Arbeitsspeicher verfügbar ist, E_INVALIDARG, wenn StartIndex ungültig ist, oder S_FALSE, wenn keine Farben in der Palette vorhanden sind.

Bemerkungen

Diese Memberfunktion gibt die aktuelle Palette des Videos als vom Benutzer zugeordnetes Array zurück. Um konsistent zu bleiben, verwenden Sie die Member in der Win32 PALETTEENTRY-Struktur , um die Farben zurückzugeben, anstatt die Member in der RGBQUAD-Struktur (obwohl der Parameter ein LONG ist). Der Speicher wird vom Aufrufer zugewiesen, also kopieren Sie einfach nacheinander. Stellen Sie fest, dass die Anzahl der angeforderten Einträge und der Startpositionsoffset gültig sind. Wenn die Anzahl der Einträge auf null ausgewertet wird, geben Sie einen S_FALSE Code zurück.

Anforderungen

Siehe auch

CBaseControlVideo-Klasse