共用方式為

IMFByteStream：：BeginWrite 方法 (mfobjects.h)

  • 發行項

開始對數據流進行異步寫入作業。

語法

HRESULT BeginWrite(
  [in] const BYTE       *pb,
  [in] ULONG            cb,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

參數

[in] pb

緩衝區的指標，其中包含要寫入的數據。

[in] cb

以位元組為單位的緩衝區大小。

[in] pCallback

回呼物件的 IMFAsyncCallback 介面指標。 呼叫端必須實作這個介面。

[in] punkState

狀態物件的 IUnknown 介面指標，由呼叫端定義。 此參數可以是 Null。 您可以使用這個物件來儲存狀態資訊。 叫用回呼時，物件會傳回給呼叫端。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

當所有數據都寫入數據流時，會呼叫回呼物件的 IMFAsyncCallback：：Invoke 方法。 此時，應用程式應該呼叫 IMFByteStream：：EndWrite 來完成異步要求。

當異步寫入仍在擱置時，請勿重新配置、釋放或寫入緩衝區。

實作注意事項：這個方法應該藉由將寫入數據流的位元元組數目新增至數據流來更新數據流中的目前位置，該值是由 在wwwWritten中傳回的值所指定到目前位置。 其他可更新目前位置的方法包括 Read、 BeginRead、 Write、 Seek 和 SetCurrentPosition。

如果已安裝 Windows Media Format 11 SDK 可轉散發元件，此介面可在下列平臺上使用：

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

規格需求

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

另請參閱

IMFByteStream