IMFByteStream::GetCapabilities-Methode (mfobjects.h)

  • Artikel

Ruft die Merkmale des Bytestreams ab.

Syntax

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Parameter

[out] pdwCapabilities

Empfängt ein bitweises OR mit 0 oder mehr Flags. Die folgenden Flags sind definiert.

Wert Bedeutung
MFBYTESTREAM_IS_READABLE
0x00000001
 Der Bytedatenstrom kann gelesen werden.
MFBYTESTREAM_IS_WRITABLE
0x00000002
 Der Bytedatenstrom kann in geschrieben werden.
MFBYTESTREAM_IS_SEEKABLE
0x00000004
 Der Bytestream kann gesucht werden.
MFBYTESTREAM_IS_REMOTE
0x00000008
 Der Bytedatenstrom stammt aus einer Remotequelle, z. B. einem Netzwerk.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
 Der Bytestream stellt ein Dateiverzeichnis dar.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
 Die Suche innerhalb dieses Streams kann langsam sein. Beispielsweise kann der Bytestream aus einem Netzwerk heruntergeladen werden.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
 Der Bytestream lädt derzeit Daten in einen lokalen Cache herunter. Lesevorgänge für den Bytedatenstrom können länger dauern, bis die Daten vollständig heruntergeladen wurden.

Dieses Flag wird gelöscht, nachdem alle Daten heruntergeladen wurden.

Wenn auch das flag MFBYTESTREAM_HAS_SLOW_SEEK festgelegt ist, bedeutet dies, dass der Bytedatenstrom die gesamte Datei sequenziell herunterladen muss. Andernfalls kann der Bytestream auf Suchanforderungen reagieren, indem er den Download von einem neuen Punkt im Stream neu startet.
MFBYTESTREAM_SHARE_WRITE
0x00000400
 Ein anderer Thread oder Prozess kann diesen Bytestream zum Schreiben öffnen. Wenn dieses Flag vorhanden ist, kann sich die Länge des Bytedatenstroms ändern, während er gelesen wird.

Dieses Flag kann sich auf das Verhalten von Bytestreamhandlern auswirken. Weitere Informationen finden Sie unter MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE.

Hinweis Erfordert Windows 7 oder höher.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
 Der Bytedatenstrom verwendet derzeit nicht das Netzwerk, um den Inhalt zu empfangen. Netzwerkhardware kann in einen Energiesparzustand versetzt werden, wenn dieses Bit festgelegt ist.
Hinweis Erfordert Windows 8 oder höher.
 

Rückgabewert

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

Hinweise

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

IMFByteStream