MFPCreateMediaPlayer-Funktion (mfplay.h)

Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.

 

Erstellt eine neue instance des MFPlay-Playerobjekts.

Syntax

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

Parameter

[in] pwszURL

Null-beendete Zeichenfolge, die die URL einer zu öffnenden Mediendatei enthält. Dieser Parameter kann NULL sein. Wenn der Parameter NULL ist, muss fStartPlaybackFALSE sein.

Wenn dieser Parameter NULL ist, können Sie eine URL später öffnen, indem Sie IMFPMediaPlayer::CreateMediaItemFromURL aufrufen.

[in] fStartPlayback

Bei TRUE wird die Wiedergabe automatisch gestartet. Bei FALSE wird die Wiedergabe erst gestartet, wenn die Anwendung IMFMediaPlayer::P lay aufruft.

Wenn pwszURLNULL ist, wird dieser Parameter ignoriert.

[in] creationOptions

Bitweise OR von null von weiteren Flags aus der _MFP_CREATION_OPTIONS-Enumeration .

[in] pCallback

Zeiger auf die IMFPMediaPlayerCallback-Schnittstelle eines Rückrufobjekts, das von der Anwendung implementiert wird. Verwenden Sie diese Schnittstelle, um Ereignisbenachrichtigungen vom MFPlay-Playerobjekt abzurufen. Dieser Parameter kann NULL sein. Wenn der Parameter NULL ist, empfängt die Anwendung keine Ereignisbenachrichtigungen vom Playerobjekt.

[in] hWnd

Ein Handle für ein Fenster, in dem das Video angezeigt wird. Für die reine Audiowiedergabe kann dieser Parameter NULL sein.

Das von hWnd angegebene Fenster wird für den ersten ausgewählten Videostream in der Quelle verwendet. Wenn die Quelle über mehrere Videostreams verfügt, müssen Sie IMFPMediaItem::SetStreamSink aufrufen, um einen der Videostreams nach dem ersten zu rendern.

Wenn hWndNULL ist, zeigt MFPlay kein Video an, es sei denn, die Anwendung ruft IMFPMediaItem::SetStreamSink auf, um eine Mediensenke für den Videodatenstrom anzugeben.

[out] ppMediaPlayer

Empfängt einen Zeiger auf die IMFPMediaPlayer-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann NULL sein. Wenn dieser Parameter NULL ist, muss fStartPlaybackTRUE sein, und pwszURL kann nicht NULL sein.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Rufen Sie vor dem Aufrufen dieser Funktion CoIntialize(Ex) aus demselben Thread auf, um die COM-Bibliothek zu initialisieren.

Intern ruft MFPCreateMediaPlayerMFStartup auf, um die Microsoft Media Foundation-Plattform zu initialisieren. Wenn das Playerobjekt zerstört wird, ruft es MFShutdown auf, um die Plattform herunterzufahren. Es ist nicht erforderlich, dass eine Anwendung MFStartup oder MFShutdown aufruft , wenn MFPlay verwendet wird.

Hinweis Wenn Sie andere Media Foundation-APIs außerhalb der Lebensdauer des Playerobjekts verwenden, sollte Ihre Anwendung MFStartup und MFShutdown aufrufen.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfplay.h
Bibliothek	Mfplay.lib
DLL	Mfplay.dll

Weitere Informationen

Media Foundation-Funktionen

Verwenden von MFPlay für die Audio-/Videowiedergabe