Metodo CBaseControlVideo.GetVideoPaletteEntries

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetVideoPaletteEntries metodo recupera un intervallo di voci della tavolozza per il video.

Sintassi

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

Parametri

Startindex

Voce della tavolozza iniziale in base zero.

Voci

Numero di voci necessarie.

pRetrieved

Puntatore al numero di colori ottenuti.

pPalette

Puntatore al buffer di output per i colori.

Valore restituito

Restituisce NOERROR se ha esito positivo, VFW_E_NO_PALETTE_AVAILABLE se gli esempi di video non hanno una tavolozza dei colori, E_OUTOFMEMORY se non è disponibile memoria sufficiente, E_INVALIDARG se StartIndex non è valido o S_FALSE se non sono presenti colori nella tavolozza.

Commenti

Questa funzione membro restituisce la tavolozza corrente del video come matrice allocata dall'utente. Per rimanere coerenti, usare i membri nella struttura Win32 PALETTEENTRY per restituire i colori, anziché i membri nella struttura RGBQUAD (anche se il parametro è un LONG). La memoria viene allocata dal chiamante, quindi copiare ogni volta. Determinare che il numero di voci richieste e l'offset della posizione iniziale sono entrambi validi. Se il numero di voci restituisce zero, restituisce un codice S_FALSE.

Requisiti

Vedi anche

Classe CBaseControlVideo