共用方式為

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 可轉散發元件，此介面可在下列平臺上使用：

  • Windows XP with Service Pack 2 (SP2) 和更新版本。
  • 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center 版本 2005) 和 KB925766 (2006 年 10 月更新匯總) 。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (include Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

IMFByteStream