Compartilhar via


Funções de tipo de mídia

[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.]

As classes base do DirectShow fornecem funções auxiliares para lidar com a estrutura AM_MEDIA_TYPE .

A estrutura AM_MEDIA_TYPE contém um ponteiro (o membro pbFormat ) para outro bloco de memória, que é chamado de bloco de formato. Ao trabalhar com essa estrutura, portanto, você deve ter cuidado com a alocação de memória para evitar vazamentos de memória.

As seguintes funções alocam memória:

  • CreateMediaType aloca uma nova estrutura de AM_MEDIA_TYPE e o bloco de formato.
  • CopyMediaType copia para uma estrutura de AM_MEDIA_TYPE existente, mas aloca o bloco de formato.
  • CreateAudioMediaType inicializa uma estrutura de AM_MEDIA_TYPE existente e, opcionalmente, aloca o bloco de formato.

As seguintes funções liberam memória:

  • FreeMediaType libera o bloco de formato.
  • DeleteMediaType libera uma estrutura de AM_MEDIA_TYPE , incluindo o bloco de formato.
Função Descrição
CopyMediaType Copia uma estrutura de AM_MEDIA_TYPE alocada por tarefa.
CreateAudioMediaType Inicializa uma estrutura de tipo de mídia dada uma estrutura de formato de onda.
CreateMediaType Aloca e inicializa uma estrutura AM_MEDIA_TYPE , de uma estrutura de AM_MEDIA_TYPE existente.
Deletemediatype Exclui uma estrutura de AM_MEDIA_TYPE alocada por tarefa.
FreeMediaType Libera uma estrutura de AM_MEDIA_TYPE alocada por tarefa da memória.

 

Requisitos

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