Méthode IMFPMediaItem ::GetURL (mfplay.h)

  • Article
Important Déconseillée. Cette API peut être supprimée des versions ultérieures de Windows. Les applications doivent utiliser la session multimédia pour la lecture.
 

Obtient l’URL utilisée pour créer l’élément multimédia.

Syntaxe

HRESULT GetURL(
  [out] LPWSTR *ppwszURL
);

Paramètres

[out] ppwszURL

Reçoit un pointeur vers une chaîne terminée par null qui contient l’URL. L’appelant doit libérer la chaîne en appelant CoTaskMemFree.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_NOTFOUND
 Aucune URL n’est associée à cet élément multimédia.
MF_E_SHUTDOWN
 La méthode IMFPMediaPlayer ::Shutdown a été appelée.

Remarques

Cette méthode s’applique lorsque l’application appelle IMFPMediaPlayer ::CreateMediaItemFromURL pour créer un élément multimédia. Si l’application appelle IMFPMediaPlayer ::CreateMediaItemFromObject pour créer un élément multimédia, la méthode GetURL pour cet élément multimédia retourne MF_E_NOTFOUND.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfplay.h

Voir aussi

IMFPMediaItem

IMFPMediaPlayer ::CreateMediaItemFromURL

Utilisation de MFPlay pour la lecture audio/vidéo