Método CBaseControlVideo.GetVideoPaletteEntries

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetVideoPaletteEntries método recupera un intervalo de entradas de paleta para el vídeo.

Sintaxis

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

Parámetros

Startindex

Entrada de paleta de inicio de base cero.

Entradas

Número de entradas necesarias.

pRetrieved

Puntero al número de colores obtenidos.

pPalette

Puntero al búfer de salida para los colores.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente, VFW_E_NO_PALETTE_AVAILABLE si los ejemplos de vídeo no tienen paleta de colores, E_OUTOFMEMORY si no hay suficiente memoria disponible, E_INVALIDARG si StartIndex no es válido o S_FALSE si no hay colores en la paleta.

Observaciones

Esta función miembro devuelve la paleta actual del vídeo como una matriz asignada por el usuario. Para mantener la coherencia, use los miembros de la estructura PALETTEENTRY de Win32 para devolver los colores, en lugar de los miembros de la estructura RGBQUAD (aunque el parámetro es LONG). El autor de la llamada asigna la memoria, por lo que solo tiene que copiar cada uno a su vez. Determine que el número de entradas solicitadas y el desplazamiento de posición inicial son válidos. Si el número de entradas se evalúa como cero, devuelve un código S_FALSE.

Requisitos

Requisito Value
Encabezado
Ctlutil.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseControlVideo (clase)