Método CMediaType.ReallocFormatBuffer

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O ReallocFormatBuffer método realoca o bloco de formato para um novo tamanho.

Sintaxe

BYTE* ReallocFormatBuffer(
   ULONG length
);

Parâmetros

length

Novo tamanho necessário para o bloco de formato, em bytes. Deve ser maior que zero.

Retornar valor

Retorna um ponteiro para o novo bloco se tiver êxito. Caso contrário, retorna um ponteiro para o bloco de formato antigo ou NULL.

Comentários

Esse método aloca um novo bloco de formato. Ele copia o máximo possível do bloco de formato existente no novo bloco de formato. Se o novo bloco for menor que o bloco existente, o bloco de formato existente será truncado. Se o novo bloco for maior, o conteúdo do espaço adicional será indefinido. Eles não são explicitamente definidos como zero.

O método atualiza os membros cbFormat e pbFormat da estrutura AM_MEDIA_TYPE .

Requisitos

Requisito Valor
parâmetro
Mtype.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CMediaType