Méthode IMFMediaEngine::CanPlayType (mfmediaengine.h)

  • Article

Interroge la probabilité que le moteur multimédia puisse lire un type spécifié de ressource multimédia.

Syntaxe

HRESULT CanPlayType(
  [in]  BSTR                    type,
  [out] MF_MEDIA_ENGINE_CANPLAY *pAnswer
);

Paramètres

[in] type

Chaîne qui contient un type MIME avec un paramètre de codecs facultatif, tel que défini dans RFC 4281.

[out] pAnswer

Reçoit une valeur d’énumération MF_MEDIA_ENGINE_CANPLAY .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Cette méthode correspond à l’attribut canPlayType de l’interface HTMLMediaElement dans HTML5.

L’attribut canPlayType définit les valeurs suivantes.

Valeur Description
"" (chaîne vide) L’agent utilisateur ne peut pas lire la ressource, ou le type de ressource est « application/octet-stream ».
« probablement » L’agent utilisateur peut probablement lire la ressource.
« peut-être » Aucune des valeurs précédentes ne s’applique.
 

La valeur « probablement » est utilisée, car un type MIME pour une ressource multimédia n’est généralement pas une description complète de la ressource. Par exemple, « video/mp4 » spécifie un fichier MP4 avec vidéo, mais ne décrit pas le codec. Même avec le paramètre de codecs facultatifs, le type MIME omet certaines informations, telles que le débit binaire codé réel. Par conséquent, il est généralement impossible d’être certain que la lecture est possible tant que la ressource multimédia réelle n’est pas ouverte.

Spécifications

   
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête mfmediaengine.h

Voir aussi

IMFMediaEngine