IMFPMediaItem::GetUserData-Methode (mfplay.h)

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

 

Ruft den anwendungsdefinierten Wert ab, der im Medienelement gespeichert ist.

Syntax

HRESULT GetUserData(
  [out] DWORD_PTR *pdwUserData
);

Parameter

[out] pdwUserData

Empfängt den von der Anwendung definierten Wert für das Medienelement.

Rückgabewert

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

Hinweise

Sie können diesen Wert beim ersten Erstellen des Medienelements zuweisen, indem Sie ihn im dwUserData-Parameter der IMFPMediaPlayer::CreateMediaItemFromURL - oder IMFPMediaPlayer::CreateMediaItemFromObject-Methode angeben. Um den Wert zu aktualisieren, rufen Sie IMFPMediaItem::SetUserData auf.

Diese Methode kann aufgerufen werden, nachdem das Player-Objekt heruntergefahren wurde.

Anforderungen

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

Weitere Informationen

IMFPMediaItem

Verwenden von MFPlay für die Audio-/Videowiedergabe