Funzione MFStartup (mfapi.h)
Inizializza Microsoft Media Foundation.
Sintassi
HRESULT MFStartup(
ULONG Version,
DWORD dwFlags
);
Parametri
Version
Numero di versione. Usare il valore MF_VERSION, definito in mfapi.h.
dwFlags
Questo parametro è facoltativo quando si usa C++ ma richiesto in C. Il valore deve essere uno dei flag seguenti:
| Valore | Significato |
|---|---|
|
Non inizializzare la libreria socket. |
|
Equivalente a MFSTARTUP_NOSOCKET. |
|
Inizializzare l'intera piattaforma Media Foundation. Si tratta del valore predefinito quando dwFlags non è specificato. |
Valore restituito
La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro Version richiede una versione più recente di Media Foundation rispetto alla versione in esecuzione. |
|
La piattaforma Media Foundation è disabilitata perché il sistema è stato avviato in modalità provvisoria (avvio non sicuro). |
|
Media Foundation non viene implementato nel sistema. Questo errore può verificarsi se i componenti multimediali non sono presenti (vedere KB2703761 per altre informazioni). |
Commenti
Un'applicazione deve chiamare questa funzione prima di usare Media Foundation. Prima che l'applicazione venga chiusa, chiamare MFShutdown una volta per ogni chiamata precedente a MFStartup.
MFStartup deve essere chiamato durante l'inizializzazione dell'app e non da costruttori statici durante l'inizializzazione del processo.
Non chiamare MFStartup o MFShutdown dai thread della coda di lavoro. Per altre informazioni sulle code di lavoro, vedere Code di lavoro.
Questa funzione è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:
- Windows XP con Service Pack 2 (SP2) e versioni successive.
- Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.
Esempio
hr = MFStartup(MF_VERSION);
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 | mfapi.h |
| Libreria | Mfplat.lib |
| DLL | Mfplat.dll |