IMFByteStream 介面 (mfobjects.h)

代表來自某些數據源的位元組數據流，可能是本機檔案、網路檔案或其他來源。 IMFByteStream 介面支援一般串流作業，例如讀取、寫入和搜尋。

繼承

IMFByteStream 介面繼承自 IUnknown 介面。 IMFByteStream 也有下列類型的成員：

方法

IMFByteStream 介面具有這些方法。

IMFByteStream：：BeginRead 從數據流開始異步讀取作業。
IMFByteStream：：BeginWrite 開始對數據流進行異步寫入作業。
IMFByteStream：：Close 關閉數據流，並釋放與數據流相關聯的任何資源，例如套接字或檔句柄。 此方法也會取消任何擱置的異步 I/O 要求。
IMFByteStream：：EndRead 完成異步讀取作業。
IMFByteStream：：EndWrite 完成異步寫入作業。
IMFByteStream：：Flush 清除數據流所使用的任何內部緩衝區。 如果您要寫入數據流，則緩衝的數據會寫入基礎檔案或裝置。
IMFByteStream：：GetCapabilities 擷取位元組數據流的特性。
IMFByteStream：：GetCurrentPosition 擷取數據流中目前的讀取或寫入位置。
IMFByteStream：：GetLength 擷取數據流的長度。
IMFByteStream：：IsEndOfStream 查詢目前的位置是否已到達數據流的結尾。
IMFByteStream：：Read 從數據流讀取數據。
IMFByteStream：：Seek 依指定的位移移動數據流中的目前位置。
IMFByteStream：：SetCurrentPosition 設定目前的讀取或寫入位置。
IMFByteStream：：SetLength 設定資料流的長度。
IMFByteStream：：Write 寫入資料至資料流。

備註

下列函式會傳回本機檔案的 IMFByteStream 指標：

• MFBeginCreateFile
• MFCreateFile
• MFCreateTempFile

媒體來源的位元組數據流可以使用讀取許可權來開啟。 封存媒體接收的位元組數據流應該以讀取和寫入存取權開啟。 (可能需要讀取許可權，因為封存接收可能需要讀取檔案的部分，因為它寫入.)

此介面的某些實作也會公開下列一或多個介面：

• IMFAttributes
• IMFByteStreamBuffering
• IMFByteStreamCacheControl
• IMFGetService
• IMFMediaEventGenerator

如果已安裝 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)

另請參閱

位元組 Stream 屬性

IMFByteStreamBuffering

媒體基礎介面