Funzione MFCreatePMPMediaSession (mfidl.h)

Articolo
08/24/2023

Crea un'istanza della sessione multimediale all'interno di un processo PMP (Protected Media Path).

Sintassi

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

Parametri

dwCreationFlags

Membro dell'enumerazione MFPMPSESSION_CREATION_FLAGS che specifica come creare l'oggetto sessione.

pConfiguration

Puntatore all'interfaccia IMFAttributes . Questo parametro può essere NULL. Vedere la sezione Osservazioni.

ppMediaSession

Riceve un puntatore all'interfaccia FMIMediaSession della sessione multimediale PMP. Il chiamante deve rilasciare l'interfaccia. Prima di rilasciare l'ultimo riferimento al puntatore IMFMediaSession , l'applicazione deve chiamare il metodo IMFMediaSession::Shutdown .

ppEnablerActivate

Riceve un puntatore all'interfaccia FMActivate o al valore NULL. Se non NULL, il chiamante deve rilasciare l'interfaccia. Vedere la sezione Osservazioni.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Funzione completata.

Commenti

È possibile usare il parametro pConfiguration per impostare uno degli attributi seguenti:

Se questa funzione non può creare la sessione multimediale PMP perché è stato revocato un file binario attendibile, il parametro ppEnablerActivate riceve un puntatore dell'interfaccia FMActivate . L'applicazione può usare questo puntatore per creare un oggetto di abilitazione del contenuto, che può quindi essere usato per scaricare un file binario aggiornato:

Chiamare FMActivate::ActivateObject con l'identificatore dell'interfaccia IID_IMFContentEnabler per ottenere un puntatore dell'interfaccia FMContentEnabler .
Usare tale interfaccia per scaricare il file binario aggiornato.
Chiamare di nuovo MFCreatePMPMediaSession .

Se la funzione crea correttamente la sessione multimediale PMP, il parametro ppEnablerActivate riceve il valore NULL.

Non effettuare chiamate alla sessione multimediale PMP da un thread che elabora un messaggio di finestra inviato da un altro thread. Per verificare se il thread corrente rientra in questa categoria, chiamare InSendMessage.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mf.lib
DLL	Mf.dll

Vedi anche

MFCreateMediaSession

Funzioni di Media Foundation

Sessione multimediale PMP

Percorso multimediale protetto

Condividi tramite