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

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