Función MFCreatePMPMediaSession (mfidl.h)

  • Artículo

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:

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