Método CMediaType.ReallocFormatBuffer

[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 ReallocFormatBuffer método reasigna el bloque de formato a un nuevo tamaño.

Sintaxis

BYTE* ReallocFormatBuffer(
   ULONG length
);

Parámetros

length

Nuevo tamaño necesario para el bloque de formato, en bytes. Debe ser mayor que cero.

Valor devuelto

Devuelve un puntero al nuevo bloque si se ejecuta correctamente. De lo contrario, devuelve un puntero al bloque de formato antiguo o NULL.

Observaciones

Este método asigna un nuevo bloque de formato. Copia tanto el bloque de formato existente como sea posible en el nuevo bloque de formato. Si el nuevo bloque es menor que el bloque existente, se trunca el bloque de formato existente. Si el nuevo bloque es mayor, el contenido del espacio adicional no está definido. No se establecen explícitamente en cero.

El método actualiza los miembros cbFormat y pbFormat de la estructura AM_MEDIA_TYPE .

Requisitos

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

Consulte también

CMediaType (clase)