Compartir a través de

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

  • Artículo

Establece el tipo de medio del objeto.

Sintaxis

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

Parámetros

[in] pMediaType

Puntero a la interfaz IMFMediaType del nuevo tipo de medio.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_INVALIDREQUEST
 Solicitud no válida.

Comentarios

En el caso de los orígenes multimedia, establecer el tipo de medio significa que el origen generará datos que se ajusten a ese tipo de medio. En el caso de los receptores multimedia, establecer el tipo de medio significa que el receptor puede recibir datos que se ajusten a ese tipo de medio.

Cualquier implementación de este método debe comprobar si pMediaType difiere del tipo de medio actual del objeto. Si los tipos son idénticos, el método debe devolver S_OK pero evitar liberar y volver a crear recursos innecesariamente. Si los tipos no son idénticos, el método debe validar el nuevo tipo.

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

IMFMediaTypeHandler