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 |
|---|---|
|
Esta apresentação requer um ambiente protegido. |
|
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 |