Função MFRequireProtectedEnvironment (mfidl.h)

Consulta se uma apresentação de mídia requer o PMP (Caminho de Mídia Protegida).

Sintaxe

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

Parâmetros

[in] pPresentationDescriptor

Ponteiro para a interface IMFPresentationDescriptor de um descritor de apresentação. O descritor de apresentação é criado pela fonte de mídia e descreve a apresentação.

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	Esta apresentação requer um ambiente protegido.
S_FALSE	Esta apresentação não requer um ambiente protegido.

Comentários

Se essa função retornar S_OK, isso significa que o PMP é necessário para esta apresentação. Chame MFCreatePMPMediaSession para criar o objeto de sessão PMP.

Se a função retornar S_FALSE, você poderá usar o pipeline desprotegido. Chame MFCreateMediaSession para criar o objeto de Sessão de Mídia regular.

Internamente, essa função verifica se algum dos descritores de fluxo na apresentação tem o atributo MF_SD_PROTECTED com o valor TRUE.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfidl.h
Biblioteca	Mf.lib
DLL	Mf.dll

Confira também

Funções do Media Foundation