IMFMediaEngine::CanPlayType-Methode (mfmediaengine.h)

  • Artikel

Fragt ab, wie wahrscheinlich es ist, dass die Medien-Engine einen angegebenen Typ von Medienressourcen wiedergeben kann.

Syntax

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

Parameter

[in] type

Eine Zeichenfolge, die einen MIME-Typ mit einem optionalen Codecs-Parameter enthält, wie in RFC 4281 definiert.

[out] pAnswer

Empfängt einen MF_MEDIA_ENGINE_CANPLAY Enumerationswert.

Rückgabewert

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

Hinweise

Diese Methode entspricht dem canPlayType-Attribut der HTMLMediaElement-Schnittstelle in HTML5.

Das canPlayType-Attribut definiert die folgenden Werte.

Wert BESCHREIBUNG
"" (leere Zeichenfolge) Der Benutzer-Agent kann die Ressource nicht wiedergeben, oder der Ressourcentyp lautet "application/octet-stream".
"wahrscheinlich" Der Benutzer-Agent kann die Ressource wahrscheinlich wiedergeben.
"vielleicht" Keiner der vorherigen Werte gilt.
 

Der Wert "wahrscheinlich" wird verwendet, da ein MIME-Typ für eine Medienressource in der Regel keine vollständige Beschreibung der Ressource ist. "video/mp4" gibt beispielsweise eine MP4-Datei mit Video an, beschreibt jedoch nicht den Codec. Auch mit dem optionalen Codecs-Parameter werden vom MIME-Typ einige Informationen weggelassen, z. B. die tatsächliche codierte Bitrate. Daher ist es in der Regel unmöglich, sicher zu sein, dass die Wiedergabe möglich ist, bis die tatsächliche Medienressource geöffnet ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfmediaengine.h

Weitere Informationen

IMFMediaEngine