Skip to content

Latest commit

 

History

History
202 lines (170 loc) · 6.54 KB

nf-mfobjects-imfbytestream-getcapabilities.md

File metadata and controls

202 lines (170 loc) · 6.54 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mfobjects.IMFByteStream.GetCapabilities
IMFByteStream::GetCapabilities (mfobjects.h)
Retrieves the characteristics of the byte stream.
715e802b-4707-4c6d-9ae9-a4ddfa90f05e
GetCapabilities
GetCapabilities method [Media Foundation]
GetCapabilities method [Media Foundation]
IMFByteStream interface
IMFByteStream interface [Media Foundation]
GetCapabilities method
IMFByteStream.GetCapabilities
IMFByteStream::GetCapabilities
MFBYTESTREAM_DOES_NOT_USE_NETWORK
MFBYTESTREAM_HAS_SLOW_SEEK
MFBYTESTREAM_IS_DIRECTORY
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
MFBYTESTREAM_IS_READABLE
MFBYTESTREAM_IS_REMOTE
MFBYTESTREAM_IS_SEEKABLE
MFBYTESTREAM_IS_WRITABLE
MFBYTESTREAM_SHARE_WRITE
mf.imfbytestream_getcapabilities
mfobjects/IMFByteStream::GetCapabilities
mf\imfbytestream_getcapabilities.htm
mf
715e802b-4707-4c6d-9ae9-a4ddfa90f05e
12/05/2018
715e802b-4707-4c6d-9ae9-a4ddfa90f05e, GetCapabilities, GetCapabilities method [Media Foundation], GetCapabilities method [Media Foundation],IMFByteStream interface, IMFByteStream interface [Media Foundation],GetCapabilities method, IMFByteStream.GetCapabilities, IMFByteStream::GetCapabilities, MFBYTESTREAM_DOES_NOT_USE_NETWORK, MFBYTESTREAM_HAS_SLOW_SEEK, MFBYTESTREAM_IS_DIRECTORY, MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED, MFBYTESTREAM_IS_READABLE, MFBYTESTREAM_IS_REMOTE, MFBYTESTREAM_IS_SEEKABLE, MFBYTESTREAM_IS_WRITABLE, MFBYTESTREAM_SHARE_WRITE, mf.imfbytestream_getcapabilities, mfobjects/IMFByteStream::GetCapabilities
mfobjects.h
Mfidl.h
Windows
Windows Vista [desktop apps \| UWP apps]
Windows Server 2008 [desktop apps \| UWP apps]
Mfuuid.lib
Windows
19H1
IMFByteStream::GetCapabilities
mfobjects/IMFByteStream::GetCapabilities
c++
APIRef
kbSyntax
COM
mfuuid.lib
mfuuid.dll
IMFByteStream.GetCapabilities

IMFByteStream::GetCapabilities

-description

Retrieves the characteristics of the byte stream.

-parameters

-param pdwCapabilities [out]

Receives a bitwise OR of zero or more flags. The following flags are defined.

Value Meaning
MFBYTESTREAM_IS_READABLE
0x00000001
The byte stream can be read.
MFBYTESTREAM_IS_WRITABLE
0x00000002
The byte stream can be written to.
MFBYTESTREAM_IS_SEEKABLE
0x00000004
The byte stream can be seeked.
MFBYTESTREAM_IS_REMOTE
0x00000008
The byte stream is from a remote source, such as a network.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
The byte stream represents a file directory.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
Seeking within this stream might be slow. For example, the byte stream might download from a network.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
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.

MFBYTESTREAM_SHARE_WRITE
0x00000400
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.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
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.
 

-returns

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.

-see-also

IMFByteStream