Condividi tramite


Metodo IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)

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 .

 

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