Macro ICGetState (vfw.h)

La macro ICGetState consulta un controlador de compresión de vídeo para devolver su configuración actual en un bloque de memoria. Puede usar esta macro o llamar explícitamente al mensaje ICM_GETSTATE .

Sintaxis

DWORD ICGetState(
     hic,
     pv,
     cb
);

Parámetros

hic

Manija del compresor.

pv

Puntero a un bloque de memoria que contiene la información de configuración actual. Puede especificar NULL para este parámetro para determinar la cantidad de memoria necesaria para la información de configuración, como en ICGetStateSize.

cb

Tamaño, en bytes, del bloque de memoria.

Valor devuelto

Tipo: DWORD de

Si pv es NULL, devuelve la cantidad de memoria, en bytes, necesaria para la información de configuración. Si pv no es NULL, devuelve ICERR_OK si se ejecuta correctamente o si se produce un error en caso contrario.

Observaciones

La macro ICGetStateSize devuelve el número de bytes usados por los datos de estado.

La estructura utilizada para representar la información de configuración es específica del controlador y la define el controlador.

Use ICGetStateSize antes de llamar a la macro ICGetState para determinar el tamaño del búfer que se va a asignar para la llamada.

Requisitos

Consulte también

Macros de compresión de vídeo

administrador de compresión de vídeo