Funzione MFStartup (mfapi.h)

Articolo
02/28/2024

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

Condividi tramite