IMFByteStream：：GetCapabilities 方法 (mfobjects.h)

检索字节流的特征。

语法

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

[out] pdwCapabilities

接收零个或多个标志的按位 OR 。定义了以下标志。

值	含义
MFBYTESTREAM_IS_READABLE 0x00000001	可以读取字节流。
MFBYTESTREAM_IS_WRITABLE 0x00000002	字节流可以写入。
MFBYTESTREAM_IS_SEEKABLE 0x00000004	可以查找字节流。
MFBYTESTREAM_IS_REMOTE 0x00000008	字节流来自远程源，例如网络。
MFBYTESTREAM_IS_DIRECTORY 0x00000080	字节流表示文件目录。
MFBYTESTREAM_HAS_SLOW_SEEK 0x00000100	在此流中查找可能很慢。例如，字节流可能从网络下载。
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED 0x00000200	字节流当前正在将数据下载到本地缓存。在完全下载数据之前，对字节流执行读取操作可能需要更长的时间。下载所有数据后，会清除此标志。如果还设置了 MFBYTESTREAM_HAS_SLOW_SEEK 标志，则表示字节流必须按顺序下载整个文件。否则，字节流可以通过从流中的新点重启下载来响应搜寻请求。
MFBYTESTREAM_SHARE_WRITE 0x00000400	另一个线程或进程可以打开此字节流进行写入。如果存在此标志，则在读取字节流时，字节流的长度可能会更改。此标志可能会影响字节流处理程序的行为。有关详细信息，请参阅 MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE。注意需要 Windows 7 或更高版本。
MFBYTESTREAM_DOES_NOT_USE_NETWORK 0x00000800	字节流当前未使用网络来接收内容。设置此位后，网络硬件可能进入节能状态。注意需要Windows 8或更高版本。

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

如果安装了 Windows Media Format 11 SDK 可再发行组件，则此接口在以下平台上可用：

具有 Service Pack 2 的 Windows XP (SP2) 及更高版本。
Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和安装KB925766 (2006 年 10 月更新汇总的 Windows XP Media Center Edition) 。