enumerazione MFP_EVENT_TYPE (mfplay.h)

Articolo
03/05/2024

Importante Deprecato. Questa API può essere rimossa dalle versioni future di Windows. Le applicazioni devono usare la sessione multimediale per la riproduzione.

Definisce i tipi di evento per l'interfaccia FMPMediaPlayerCallback .

Sintassi

typedef enum MFP_EVENT_TYPE {
  MFP_EVENT_TYPE_PLAY = 0,
  MFP_EVENT_TYPE_PAUSE = 1,
  MFP_EVENT_TYPE_STOP = 2,
  MFP_EVENT_TYPE_POSITION_SET = 3,
  MFP_EVENT_TYPE_RATE_SET = 4,
  MFP_EVENT_TYPE_MEDIAITEM_CREATED = 5,
  MFP_EVENT_TYPE_MEDIAITEM_SET = 6,
  MFP_EVENT_TYPE_FRAME_STEP = 7,
  MFP_EVENT_TYPE_MEDIAITEM_CLEARED = 8,
  MFP_EVENT_TYPE_MF = 9,
  MFP_EVENT_TYPE_ERROR = 10,
  MFP_EVENT_TYPE_PLAYBACK_ENDED = 11,
  MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL = 12
} ;

Costanti


`MFP_EVENT_TYPE_PLAY` Valore: 0 La riproduzione è stata avviata. Questo evento viene inviato al completamento del metodo IMFPMediaPlayer::P lay .
`MFP_EVENT_TYPE_PAUSE` Valore: 1 La riproduzione è sospesa. Questo evento viene inviato al completamento del metodo FMPMediaPlayer::P ause .
`MFP_EVENT_TYPE_STOP` Valore: 2 La riproduzione è stata arrestata. Questo evento viene inviato al completamento del metodo FMPMediaPlayer::Stop .
`MFP_EVENT_TYPE_POSITION_SET` Valore: 3 L'oggetto lettore MFPlay ha cercato una nuova posizione di riproduzione. Questo evento viene inviato al completamento del metodo FMPMediaPlayer::SetPosition .
`MFP_EVENT_TYPE_RATE_SET` Valore: 4 La frequenza di riproduzione è stata modificata. Questo evento viene inviato al completamento del metodo FMPMediaPlayer::SetRate .
`MFP_EVENT_TYPE_MEDIAITEM_CREATED` Valore: 5 È stato creato un nuovo elemento multimediale. Questo evento viene inviato quando il metodo FMPMediaPlayer::CreateMediaItemFromURL o CreateMediaItemFromObject viene completato.
`MFP_EVENT_TYPE_MEDIAITEM_SET` Valore: 6 Un elemento multimediale è pronto per la riproduzione. Questo evento viene inviato al completamento del metodo IMFPMediaPlayer::SetMediaItem .
`MFP_EVENT_TYPE_FRAME_STEP` Valore: 7 È stata completata un'operazione in fase di frame. Questo evento viene inviato al completamento del metodo FMPMediaPlayer::FrameStep .
`MFP_EVENT_TYPE_MEDIAITEM_CLEARED` Valore: 8 L'elemento multimediale corrente è stato cancellato. Questo evento viene inviato al completamento del metodo IMFPMediaPlayer::ClearMediaItem .
`MFP_EVENT_TYPE_MF` Valore: 9 Un oggetto pipeline ha inviato un evento. L'oggetto player inoltra determinati eventi della pipeline all'applicazione. Per altre informazioni, vedere MFP_MF_EVENT.
`MFP_EVENT_TYPE_ERROR` Valore: 10 Si è verificato un errore di riproduzione.
`MFP_EVENT_TYPE_PLAYBACK_ENDED` Valore: 11 La riproduzione è stata terminata. L'oggetto lettore invia questo evento quando la riproduzione raggiunge la fine del file multimediale.
`MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL` Valore: 12 L'origine multimediale richiede l'autenticazione prima di poter riprodurre il file.

Commenti

Per ogni tipo di evento, il callback FMPMediaPlayerCallback::OnMediaPlayerEvent riceve un puntatore a una struttura di dati. La prima parte della struttura dei dati è sempre una struttura MFP_EVENT_HEADER . La tabella seguente elenca la struttura dei dati per ogni tipo di evento.

Nell'implementazione di OnMediaPlayerEvent è necessario eseguire il cast del parametro pEventHeader al tipo di struttura corretto. Per questo scopo viene definito un set di macro. Queste macro controllano il valore del tipo di evento e restituiscono NULL se esiste una mancata corrispondenza; in caso contrario, restituiscono un puntatore al tipo di struttura corretto.

Tipo di evento	Struttura dell'evento Macro cast puntatore
MFP_EVENT_TYPE_PLAY	MFP_PLAY_EVENT MFP_GET_PLAY_EVENT
MFP_EVENT_TYPE_PAUSE	MFP_PAUSE_EVENT MFP_GET_PAUSE_EVENT
MFP_EVENT_TYPE_STOP	MFP_STOP_EVENT MFP_GET_STOP_EVENT
MFP_EVENT_TYPE_POSITION_SET	MFP_POSITION_SET_EVENT MFP_GET_POSITION_SET_EVENT
MFP_EVENT_TYPE_RATE_SET	MFP_RATE_SET_EVENT MFP_GET_RATE_SET_EVENT
MFP_EVENT_TYPE_MEDIAITEM_CREATED	MFP_MEDIAITEM_CREATED_EVENT MFP_GET_MEDIAITEM_CREATED_EVENT
MFP_EVENT_TYPE_MEDIAITEM_SET	MFP_MEDIAITEM_SET_EVENT MFP_GET_MEDIAITEM_SET_EVENT
MFP_EVENT_TYPE_FRAME_STEP	MFP_FRAME_STEP_EVENT MFP_GET_FRAME_STEP_EVENT
MFP_EVENT_TYPE_MEDIAITEM_CLEARED	MFP_MEDIAITEM_CLEARED_EVENT MFP_GET_MEDIAITEM_CLEARED_EVENT
MFP_EVENT_TYPE_MF	MFP_MF_EVENT MFP_GET_MF_EVENT
MFP_EVENT_TYPE_ERROR	MFP_ERROR_EVENT MFP_GET_ERROR_EVENT
MFP_EVENT_TYPE_PLAYBACK_ENDED	MFP_PLAYBACK_ENDED_EVENT MFP_GET_PLAYBACK_ENDED_EVENT
MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL	MFP_ACQUIRE_USER_CREDENTIAL_EVENT MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	mfplay.h

Vedi anche

FMPMediaPlayerCallback

Enumerazione Media Foundation

Condividi tramite