Función MFRequireProtectedEnvironment (mfidl.h)

Consulta si una presentación multimedia requiere la ruta de acceso multimedia protegida (PMP).

Sintaxis

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

Parámetros

[in] pPresentationDescriptor

Puntero a la interfaz IMFPresentationDescriptor de un descriptor de presentación. El origen de medios crea el descriptor de presentación y describe la presentación.

Valor devuelto

La función 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	Esta presentación requiere un entorno protegido.
S_FALSE	Esta presentación no requiere un entorno protegido.

Comentarios

Si esta función devuelve S_OK, significa que el PMP es necesario para esta presentación. Llame a MFCreatePMPMediaSession para crear el objeto de sesión PMP.

Si la función devuelve S_FALSE, puede usar la canalización sin protección. Llame a MFCreateMediaSession para crear el objeto Media Session normal.

Internamente, esta función comprueba si alguno de los descriptores de secuencia de la presentación tiene el atributo MF_SD_PROTECTED con el valor TRUE.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mf.lib
Archivo DLL	Mf.dll

Consulte también

Funciones de Media Foundation