Función MFCreatePMPMediaSession (mfidl.h)

Crea una instancia de la sesión multimedia dentro de un proceso de ruta de acceso a medios protegidos (PMP).

Sintaxis

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

Parámetros

dwCreationFlags

Miembro de la enumeración MFPMPSESSION_CREATION_FLAGS que especifica cómo crear el objeto de sesión.

pConfiguration

Puntero a la interfaz IMFAttributes . Este parámetro puede ser NULL. Vea la sección Comentarios.

ppMediaSession

Recibe un puntero a la interfaz IMFMediaSession de la sesión multimedia PMP. El autor de la llamada debe liberar la interfaz . Antes de liberar la última referencia al puntero IMFMediaSession , la aplicación debe llamar al método IMFMediaSession::Shutdown .

ppEnablerActivate

Recibe un puntero a la interfaz IMFActivate o al valor NULL. Si no es NULL, el autor de la llamada debe liberar la interfaz . Vea la sección Comentarios.

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	La función se ha realizado correctamente.

Comentarios

Puede usar el parámetro pConfiguration para establecer cualquiera de los siguientes atributos:

• MF_SESSION_CONTENT_PROTECTION_MANAGER
• MF_SESSION_GLOBAL_TIME
• MF_SESSION_QUALITY_MANAGER
• MF_SESSION_REMOTE_SOURCE_MODE
• MF_SESSION_SERVER_CONTEXT
• MF_SESSION_TOPOLOADER

Si esta función no puede crear la sesión multimedia PMP porque se revocó un binario de confianza, el parámetro ppEnablerActivate recibe un puntero de interfaz IMFActivate . La aplicación puede usar este puntero para crear un objeto de habilitador de contenido, que se puede usar para descargar un binario actualizado:

1. Llame a IMFActivate::ActivateObject con el identificador de interfaz IID_IMFContentEnabler para obtener un puntero de interfaz IMFContentEnabler .
2. Use esa interfaz para descargar el binario actualizado.
3. Vuelva a llamar a MFCreatePMPMediaSession .

Si la función crea correctamente la sesión multimedia PMP, el parámetro ppEnablerActivate recibe el valor NULL.

No realice llamadas a la sesión multimedia PMP desde un subproceso que procese un mensaje de ventana enviado desde otro subproceso. Para comprobar si el subproceso actual se encuentra en esta categoría, llame a InSendMessage.

Requisitos

Requisito	Value
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	Mf.lib
Archivo DLL	Mf.dll

Consulte también

MFCreateMediaSession

Funciones de Media Foundation

Sesión multimedia de PMP

Ruta de acceso a medios protegidos