IMFSinkWriter::WriteSample 方法 (mfreadwrite.h)

將範例傳遞至接收寫入器。

語法

HRESULT WriteSample(
  [in] DWORD     dwStreamIndex,
  [in] IMFSample *pSample
);

參數

[in] dwStreamIndex

這個範例之數據流以零起始的索引。

[in] pSample

範例之 IMFSample 介面的指標。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 Description
S_OK
此方法已成功。
MF_E_INVALIDREQUEST
要求無效。

備註

您必須先呼叫 IMFSinkWriter::BeginWriting ,才能呼叫此方法。 否則,方法會 傳回MF_E_INVALIDREQUEST

根據預設,接收寫入器會封鎖 WriteSample 方法內的呼叫線程,以限制傳入數據的速率。 這可防止應用程式太快地傳遞範例。 若要停用此行為,請在建立接收寫入器時設定 MF_SINK_WRITER_DISABLE_THROTTLING 屬性。

如果已安裝適用於 Windows Vista 的平臺更新補充,則此介面可在 Windows Vista 上使用。

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新補充 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfreadwrite.h

另請參閱

IMFSinkWriter

接收寫入器