IMFSourceReaderCallback：：OnReadSample 方法 (mfreadwrite.h)

當 IMFSourceReader：：ReadSample 方法完成時呼叫。

語法

HRESULT OnReadSample(
  [in] HRESULT   hrStatus,
  [in] DWORD     dwStreamIndex,
  [in] DWORD     dwStreamFlags,
  [in] LONGLONG  llTimestamp,
  [in] IMFSample *pSample
);

參數

[in] hrStatus

狀態碼。 如果處理下一個範例時發生錯誤，此參數會包含錯誤碼。

[in] dwStreamIndex

傳遞樣本之數據流的以零起始的索引。

[in] dwStreamFlags

MF_SOURCE_READER_FLAG列舉中零個或多個旗標的位 OR。

[in] llTimestamp

範例的時間戳，或 dwStreamFlags 中所指出數據流事件的時間。 時間以 100 奈秒為單位來指定。

[in] pSample

媒體範例 之 IMFSample 介面的指標。 此參數可能是 NULL。

傳回值

傳回 HRESULT 值。 目前，來源讀取器會忽略傳回值。

備註

pSample 參數可能是 NULL。 例如，當來源讀取器到達數據流結尾時， dwStreamFlags 會包含 MF_SOURCE_READERF_ENDOFSTREAM 旗標，而 pSample 為 NULL。

如果數據流中有間距，dwStreamFlags 會包含MF_SOURCE_READERF_STREAMTICK旗標，pSample 為 NULL，llTimestamp 會指出發生間距的時間。

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

規格需求

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

另請參閱

IMFSourceReaderCallback

來源讀取器