Método CMediaType.SetFormat

[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 SetFormat método inicializa el bloque de formato.

Sintaxis

BOOL SetFormat(
   BYTE  *pFormat,
   ULONG length
);

Parámetros

pFormat

Puntero a un bloque de memoria que contiene el bloque de formato.

length

Longitud del bloque de formato, en bytes.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE si se ha producido un error.

Observaciones

Este método asigna memoria para el bloque de formato y copia el búfer especificado por pFormat en el nuevo bloque de formato. Si el tipo de medio ya contiene un bloque de formato, se libera el antiguo. El método también establece el miembro cbFormat de la estructura AM_MEDIA_TYPE .

Para establecer el tipo de formato, llame al método CMediaType::SetFormatType .

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)