Partilhar via


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 de retorno

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

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

Observações

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.

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header mfidl.h
Library Mf.lib
de DLL Mf.dll

Consulte também

Funções do Media Foundation