Metodo IMFMediaEventGenerator::GetEvent (mfobjects.h)

Recupera l'evento successivo nella coda. Questo metodo è asincrono.

Sintassi

HRESULT GetEvent(
  [in]  DWORD         dwFlags,
  [out] IMFMediaEvent **ppEvent
);

Parametri

[in] dwFlags

Specifica uno dei valori seguenti.

Valore	Significato
0	Il metodo blocca fino a quando il generatore di eventi accoda un evento.
MF_EVENT_FLAG_NO_WAIT	Il metodo restituisce immediatamente.

[out] ppEvent

Riceve un puntatore all'interfaccia IMFMediaEvent . Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Il metodo 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.
E_INVALIDARG	Argomento puntatore NULL.
MF_E_MULTIPLE_SUBSCRIBERS	Esiste una richiesta in sospeso.
MF_E_NO_EVENTS_AVAILABLE	Non sono presenti eventi nella coda.
MF_E_SHUTDOWN	L'oggetto è stato arrestato.

Commenti

Questo metodo esegue in modo sincrono.

Se la coda contiene già un evento, il metodo restituisce immediatamente S_OK. Se la coda non contiene un evento, il comportamento dipende dal valore di dwFlags:

• Se dwFlags è 0, il metodo blocca in modo indefinito fino a quando non viene accodato un nuovo evento o finché il generatore di eventi non viene arrestato.
• Se dwFlags è MF_EVENT_FLAG_NO_WAIT, il metodo ha esito negativo immediatamente con il codice restituito MF_E_NO_EVENTS_AVAILABLE.

Questo metodo restituisce MF_E_MULTIPLE_SUBSCRIBERS se in precedenza si chiama FMMediaEventGenerator::BeginGetEvent e non è ancora stato chiamato FMMediaEventGenerator::EndGetEvent.

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	mfobjects.h (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

FMMediaEventGenerator

Generatori di eventi multimediali