Funzione MFScheduleWorkItem (mfapi.h)

Articolo
02/28/2024

Pianifica un'operazione asincrona da completare dopo un intervallo specificato.

Sintassi

HRESULT MFScheduleWorkItem(
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *pState,
  [in]  INT64            Timeout,
  [out] MFWORKITEM_KEY   *pKey
);

Parametri

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback . Il chiamante deve implementare questa interfaccia.

[in] pState

Puntatore all'interfaccia IUnknown di un oggetto stato, definito dal chiamante. Questo parametro può essere NULL. È possibile usare questo oggetto per contenere informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

[in] Timeout

Intervallo di timeout, in millisecondi. Impostare questo parametro su un valore negativo. Il callback viene richiamato dopo -Timeout millisecondi. Ad esempio, se Timeout è −5000, il callback viene richiamato dopo 5000 millisecondi.

[out] pKey

Riceve una chiave che può essere usata per annullare il timer. Per annullare il timer, chiamare MFCancelWorkItem e passare questa chiave nel parametro Key .

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	Funzione completata.

Commenti

Questa funzione crea un oggetto risultato asincrono. Quando l'intervallo timer scade, viene chiamato il metodo IMFAsyncCallback::Invoke specificato da pCallback .

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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
Libreria	Mfplat.lib
DLL	Mfplat.dll

Vedi anche

MFScheduleWorkItemEx

Funzioni di Media Foundation

Code di lavoro

Condividi tramite