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 |
|---|---|
|
Operazione completata. |
|
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: 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: | Facoltativa. | Facoltativa. | Facoltativa. |
| Riproduzione audio | Uno dei casi seguenti: | 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 |