Partilhar via


Método CMediaType.AllocFormatBuffer

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 AllocFormatBuffer método aloca memória para o bloco de formato.

Sintaxe

BYTE* AllocFormatBuffer(
   ULONG length
);

Parâmetros

length

Tamanho necessário para o bloco de formato, em bytes.

Retornar valor

Retorna um ponteiro para o novo bloco se tiver êxito. Caso contrário, retornará NULL.

Comentários

Se o método alocar com êxito um novo bloco de formato, ele liberará o bloco de formato existente. Se a alocação falhar, o método deixará o bloco de formato existente.

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