Método CMediaType.SetFormat

  • Artigo

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

Sintaxe

BOOL SetFormat(
   BYTE  *pFormat,
   ULONG length
);

Parâmetros

pFormat

Ponteiro para um bloco de memória que contém o bloco de formato.

length

Comprimento do bloco de formato, em bytes.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE se ocorrer um erro.

Comentários

Esse método aloca memória para o bloco de formato e copia o buffer especificado por pFormat no novo bloco de formato. Se o tipo de mídia já contiver um bloco de formato, o antigo será liberado. O método também define o membro cbFormat da estrutura AM_MEDIA_TYPE .

Para definir o tipo de formato, chame o método CMediaType::SetFormatType .

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