Funzione MFStartup (mfapi.h)

  • Articolo

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
MFSTARTUP_NOSOCKET
 Non inizializzare la libreria socket.
MFSTARTUP_LITE
 Equivalente a MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL
 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
S_OK
 Il metodo è riuscito.
MF_E_BAD_STARTUP_VERSION
 Il parametro Version richiede una versione più recente di Media Foundation rispetto alla versione in esecuzione.
MF_E_DISABLED_IN_SAFEMODE
 La piattaforma Media Foundation è disabilitata perché il sistema è stato avviato in modalità provvisoria (avvio non sicuro).
E_NOTIMPL
 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

Vedi anche

Inizializzazione di Media Foundation

Funzioni di Media Foundation