Método IMFMediaTypeHandler::SetCurrentMediaType (mfidl.h)

  • Artigo

Define o tipo de mídia do objeto.

Sintaxe

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

Parâmetros

[in] pMediaType

Ponteiro para a interface IMFMediaType do novo tipo de mídia.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_INVALIDREQUEST
 Solicitação inválida.

Comentários

Para fontes de mídia, definir o tipo de mídia significa que a origem gerará dados em conformidade com esse tipo de mídia. Para coletores de mídia, definir o tipo de mídia significa que o coletor pode receber dados em conformidade com esse tipo de mídia.

Qualquer implementação desse método deve marcar se pMediaType difere do tipo de mídia atual do objeto. Se os tipos forem idênticos, o método deverá retornar S_OK mas evitar liberar e recriar recursos desnecessariamente. Se os tipos não forem idênticos, o método deverá validar o novo tipo.

Essa interface 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 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFMediaTypeHandler