IMFByteStream::GetCapabilities method (mfobjects.h)
Retrieves the characteristics of the byte stream.
Syntax
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Parameters
[out] pdwCapabilities
Receives a bitwise OR of zero or more flags. The following flags are defined.
Value | Meaning |
---|---|
|
The byte stream can be read. |
|
The byte stream can be written to. |
|
The byte stream can be seeked. |
|
The byte stream is from a remote source, such as a network. |
|
The byte stream represents a file directory. |
|
Seeking within this stream might be slow. For example, the byte stream might download from a network. |
|
The byte stream is currently downloading data to a local cache.
Read operations on the byte stream might take longer until the data is completely downloaded.
This flag is cleared after all of the data has been downloaded. If the MFBYTESTREAM_HAS_SLOW_SEEK flag is also set, it means the byte stream must download the entire file sequentially. Otherwise, the byte stream can respond to seek requests by restarting the download from a new point in the stream. |
|
Another thread or process can open this byte stream for writing. If this flag is present, the length of the
byte stream could change while it is being read.
This flag can affect the behavior of byte-stream handlers. For more information, see MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE. Note Requires Windows 7 or later.
|
|
The byte stream is not currently
using the network to receive the content. Networking hardware
may enter a power saving state when this bit is set.
Note Requires Windows 8 or later.
|
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This interface is available on the following platforms if the Windows Media Format 11 SDK redistributable components are installed:
- Windows XP with Service Pack 2 (SP2) and later.
- Windows XP Media Center Edition 2005 with KB900325 (Windows XP Media Center Edition 2005) and KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) installed.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2008 [desktop apps | UWP apps] |
Target Platform | Windows |
Header | mfobjects.h (include Mfidl.h) |
Library | Mfuuid.lib |