Funzione MFPCreateMediaPlayer (mfplay.h)

Articolo
08/24/2023

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

Crea una nuova istanza dell'oggetto lettore MFPlay.

Sintassi

HRESULT MFPCreateMediaPlayer(
  [in]  LPCWSTR                 pwszURL,
  [in]  BOOL                    fStartPlayback,
  [in]  MFP_CREATION_OPTIONS    creationOptions,
  [in]  IMFPMediaPlayerCallback *pCallback,
  [in]  HWND                    hWnd,
  [out] IMFPMediaPlayer         **ppMediaPlayer
);

Parametri

[in] pwszURL

Stringa con terminazione Null contenente l'URL di un file multimediale da aprire. Questo parametro può essere NULL. Se il parametro è NULL, fStartPlayback deve essere FALSE.

Se questo parametro è NULL, è possibile aprire un URL in un secondo momento chiamando IMFPMediaPlayer::CreateMediaItemFromURL.

[in] fStartPlayback

Se TRUE, la riproduzione viene avviata automaticamente. Se FALSE, la riproduzione non viene avviata finché l'applicazione non chiama IMFMediaPlayer::P lay.

Se pwszURL è NULL, questo parametro viene ignorato.

[in] creationOptions

OR bit per bit pari a zero di più flag dall'enumerazione _MFP_CREATION_OPTIONS.

[in] pCallback

Puntatore all'interfaccia IMFPMediaPlayerCallback di un oggetto callback implementato dall'applicazione. Utilizzare questa interfaccia per ricevere notifiche degli eventi dall'oggetto lettore MFPlay. Questo parametro può essere NULL. Se il parametro è NULL, l'applicazione non riceverà notifiche degli eventi dall'oggetto lettore.

[in] hWnd

Handle per una finestra in cui verrà visualizzato il video. Per la riproduzione solo audio, questo parametro può essere NULL.

La finestra specificata da hWnd viene usata per il primo flusso video selezionato nell'origine. Se l'origine include più flussi video, è necessario chiamare IMFPMediaItem::SetStreamSink per eseguire il rendering di uno dei flussi video dopo il primo.

Se hWnd è NULL, MFPlay non visualizzerà alcun video a meno che l'applicazione non chiami IMFPMediaItem::SetStreamSink per specificare un sink multimediale per il flusso video.

[out] ppMediaPlayer

Riceve un puntatore all'interfaccia IMFPMediaPlayer . Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL. Se questo parametro è NULL, fStartPlayback deve essere TRUE e pwszURL non può essere NULL.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Prima di chiamare questa funzione, chiamare CoIntialize(Ex) dallo stesso thread per inizializzare la libreria COM.

Internamente, MFPCreateMediaPlayer chiama MFStartup per inizializzare la piattaforma Microsoft Media Foundation. Quando l'oggetto lettore viene distrutto, chiama MFShutdown per arrestare la piattaforma. Non è necessario che un'applicazione chiami MFStartup o MFShutdown quando si usa MFPlay.

Nota Se si usano altre API di Media Foundation al di fuori del tempo di vita dell'oggetto lettore, l'applicazione deve chiamare MFStartup e MFShutdown.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfplay.h
Libreria	Mfplay.lib
DLL	Mfplay.dll

Vedi anche

Funzioni di Media Foundation

Uso di MFPlay per la riproduzione audio/video

Condividi tramite