Funzione MFRequireProtectedEnvironment (mfidl.h)

Esegue una query per verificare se una presentazione multimediale richiede il percorso multimediale protetto ( PMP).

Sintassi

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

Parametri

[in] pPresentationDescriptor

Puntatore all'interfaccia IMFPresentationDescriptor di un descrittore di presentazione. Il descrittore di presentazione viene creato dall'origine multimediale e descrive la presentazione.

Valore restituito

La funzione restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Questa presentazione richiede un ambiente protetto.
S_FALSE	Questa presentazione non richiede un ambiente protetto.

Commenti

Se questa funzione restituisce S_OK, significa che il PMP è necessario per questa presentazione. Chiamare MFCreatePMPMediaSession per creare l'oggetto sessione PMP.

Se la funzione restituisce S_FALSE, è possibile usare la pipeline non protetta. Chiama MFCreateMediaSession per creare il normale oggetto Sessione multimediale.

Internamente, questa funzione controlla se uno dei descrittori di flusso nella presentazione ha l'attributo MF_SD_PROTECTED con il valore TRUE.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mf.lib
DLL	Mf.dll

Vedi anche

Funzioni di Media Foundation