IMFMediaEngine::CanPlayType-Methode (mfmediaengine.h)
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 |