Compartilhar via


Função MFCreateAudioMediaType (mfapi.h)

[Essa API não tem suporte e pode ser alterada ou indisponível no futuro.]

Cria um tipo de mídia de áudio de uma estrutura WAVEFORMATEX .

Sintaxe

HRESULT MFCreateAudioMediaType(
  [in]  const WAVEFORMATEX *pAudioFormat,
  [out] IMFAudioMediaType  **ppIAudioMediaType
);

Parâmetros

[in] pAudioFormat

Ponteiro para uma estrutura WAVEFORMATEX que descreve o formato de áudio.

[out] ppIAudioMediaType

Recebe um ponteiro para a interface IMFAudioMediaType . O chamador deve liberar a interface.

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A interface IMFAudioMediaType foi preterida, portanto, os aplicativos devem evitar usar essa função. Para criar um tipo de mídia a partir de uma estrutura WAVEFORMATEX , faça o seguinte:

  1. Chame MFCreateMediaType. Essa função retorna um ponteiro para a interface IMFMediaType . O objeto de tipo de mídia retornado está inicialmente vazio.
  2. Chame MFInitMediaTypeFromWaveFormatEx para preencher o tipo de mídia da estrutura WAVEFORMATEX .
Como alternativa, você pode chamar MFCreateMediaType e definir os atributos de tipo de mídia diretamente.

Essa função estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (Pacote Cumulativo de Atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

Tipos de mídia de áudio

Funções do Media Foundation

Tipos de mídia