Metodo IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)

Articolo
08/24/2023

Crea una nuova istanza del motore multimediale.

Sintassi

HRESULT CreateInstance(
  [in]  DWORD          dwFlags,
  [in]  IMFAttributes  *pAttr,
  [out] IMFMediaEngine **ppPlayer
);

Parametri

[in] dwFlags

OR bit per bit pari a zero o più flag dall'enumerazione MF_MEDIA_ENGINE_CREATEFLAGS.

[in] pAttr

Puntatore all'interfaccia IMFAttributes di un archivio attributi.

Questo parametro specifica gli attributi di configurazione per il motore multimediale. Chiamare MFCreateAttributes per creare l'archivio attributi. Impostare quindi uno o più attributi dall'elenco di attributi del motore multimediale. Per informazioni dettagliate, vedere la sezione Osservazioni.

[out] ppPlayer

Riceve un puntatore all'interfaccia IMFMediaEngine . Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
MF_E_ATTRIBUTENOTFOUND	Manca un attributo obbligatorio da pAttr oppure è stata usata una combinazione non valida di attributi.

Commenti

Prima di chiamare questo metodo, chiamare MFStartup.

Il motore multimediale supporta tre modalità distinte:

Mode	Descrizione
Modalità server frame	In questa modalità, il motore multimediale distribuisce fotogrammi video non compressi all'applicazione. L'applicazione è responsabile della visualizzazione di ogni fotogramma, usando Microsoft Direct3D o qualsiasi altra tecnica di rendering. Il motore multimediale esegue il rendering dell'audio; l'applicazione non è responsabile del rendering audio. La modalità server frame è la modalità predefinita.
Modalità di rendering	In questa modalità, il motore multimediale esegue il rendering sia dell'audio che del video. Il rendering del video viene eseguito in una finestra o in un oggetto visivo Microsoft DirectComposition fornito dall'applicazione. Per abilitare la modalità di rendering, impostare l'attributo MF_MEDIA_ENGINE_PLAYBACK_HWND o l'attributo MF_MEDIA_ENGINE_PLAYBACK_VISUAL .
Modalità audio	In questa modalità, il motore multimediale esegue il rendering dell'audio solo senza video. Per abilitare la modalità audio, impostare il flag MF_MEDIA_ENGINE_AUDIOONLY nel parametro dwFlags .

Mode

Descrizione

Modalità server frame

In questa modalità, il motore multimediale distribuisce fotogrammi video non compressi all'applicazione. L'applicazione è responsabile della visualizzazione di ogni fotogramma, usando Microsoft Direct3D o qualsiasi altra tecnica di rendering.

Il motore multimediale esegue il rendering dell'audio; l'applicazione non è responsabile del rendering audio.

La modalità server frame è la modalità predefinita.

Modalità di rendering

In questa modalità, il motore multimediale esegue il rendering sia dell'audio che del video. Il rendering del video viene eseguito in una finestra o in un oggetto visivo Microsoft DirectComposition fornito dall'applicazione.

Per abilitare la modalità di rendering, impostare l'attributo MF_MEDIA_ENGINE_PLAYBACK_HWND o l'attributo MF_MEDIA_ENGINE_PLAYBACK_VISUAL .

Modalità audio

In questa modalità, il motore multimediale esegue il rendering dell'audio solo senza video.

Per abilitare la modalità audio, impostare il flag MF_MEDIA_ENGINE_AUDIOONLY nel parametro dwFlags .

Attributi di inizializzazione

Per il parametro pAttr vengono definiti gli attributi seguenti. Alcuni sono obbligatori e alcuni sono facoltativi, a seconda della modalità desiderata.

Funzionalità	Attributi	Modalità server frame	Modalità di rendering	Modalità audio
Callback eventi	MF_MEDIA_ENGINE_CALLBACK	Obbligatorio.	Obbligatorio.	Obbligatorio.
Destinazione di rendering	I tipi validi sono: MF_MEDIA_ENGINE_PLAYBACK_HWND MF_MEDIA_ENGINE_PLAYBACK_VISUAL Questi attributi si escludono a vicenda. Se si imposta uno di questi attributi, il motore multimediale viene impostato in modalità di rendering.	Non impostare.	Obbligatorio.	Non impostare.
Formato Direct3D	MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT	Obbligatorio.	Facoltativa.	Non impostare.
Gestione dispositivi DXGI (Microsoft DirectX Graphics Infrastructure)	MF_MEDIA_ENGINE_DXGI_MANAGER	Facoltativa.	Facoltativa.	Non impostare.
Estensioni del motore multimediale	MF_MEDIA_ENGINE_EXTENSION	Facoltativa.	Facoltativa.	Facoltativa.
Protezione del contenuto	Uno dei casi seguenti: MF_MEDIA_ENGINE_OPM_HWND MF_MEDIA_ENGINE_CONTENT_PROTECTION_FLAGS MF_MEDIA_ENGINE_CONTENT_PROTECTION_MANAGER	Facoltativa.	Facoltativa.	Facoltativa.
Riproduzione audio	Uno dei casi seguenti: MF_MEDIA_ENGINE_AUDIO_CATEGORY MF_MEDIA_ENGINE_AUDIO_ENDPOINT_ROLE	Facoltativa.	Facoltativa.	Facoltativa.

Windows Phone 8

Questa API è supportata.

Sul telefono, il motore multimediale supporta solo la modalità server frame. Il tentativo di inizializzare l'interfaccia in modalità di rendering o audio avrà esito negativo.

Requisiti


Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfmediaengine.h

Vedi anche

IMFMediaEngineClassFactory