Funzione MFLockPlatform (mfapi.h)

Blocca la funzione MFShutdown .

Sintassi

HRESULT MFLockPlatform();

Valore restituito

La funzione restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Questa funzione impedisce l'arresto dei thread della coda di lavoro quando viene chiamato MFShutdown . Usare questa funzione per assicurarsi che le operazioni asincrone vengano completate normalmente prima dell'arresto della piattaforma.

Questa funzione mantiene un blocco sulla piattaforma Media Foundation. Per sbloccare la piattaforma, chiama MFUnlockPlatform. L'applicazione deve chiamare MFUnlockPlatform una volta per ogni chiamata a MFLockPlatform.

La funzione MFShutdown si blocca fino a quando la piattaforma non viene sbloccata o fino a quando non è trascorso un periodo di attesa fisso. Il periodo di attesa è di pochi secondi. Per evitare perdite di memoria, l'applicazione deve sbloccare la piattaforma prima del termine del periodo di attesa. Ad esempio, annullare tutte le operazioni asincrone in attesa di completamento e mantenere un blocco sulla piattaforma.

L'implementazione predefinita dell'interfaccia IMFAsyncResult blocca automaticamente la piattaforma Media Foundation quando viene creato l'oggetto risultato. Il rilascio dell'interfaccia sblocca la piattaforma. Pertanto, nella maggior parte dei casi l'applicazione non deve bloccare direttamente la piattaforma. Per altre informazioni, vedere Code di lavoro.

Questa funzione è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:

• 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.

Requisiti

Vedi anche

Funzioni di Media Foundation

API della piattaforma Media Foundation

Code di lavoro