IMFSampleGrabberSinkCallback：：OnProcessSample 方法 (mfidl.h)

當取樣擷取器接收新的媒體範例時呼叫。

語法

HRESULT OnProcessSample(
  [in] REFGUID    guidMajorMediaType,
  [in] DWORD      dwSampleFlags,
  [in] LONGLONG   llSampleTime,
  [in] LONGLONG   llSampleDuration,
  [in] const BYTE *pSampleBuffer,
  [in] DWORD      dwSampleSize
);

參數

[in] guidMajorMediaType

指定資料格式的主要類型。 如需可能值的清單，請參閱 主要媒體類型。

[in] dwSampleFlags

保留的。

[in] llSampleTime

此範例的呈現時間，以 100 奈秒為單位。 如果範例沒有簡報時間，這個參數的值 就會_I64_MAX。

[in] llSampleDuration

樣本的持續時間，以 100 奈秒為單位。 如果範例沒有持續時間，則此參數的值 會_I64_MAX。

[in] pSampleBuffer

包含範例資料的緩衝區指標。

[in] dwSampleSize

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

傳回值

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

備註

如果您在播放拓撲中使用取樣抓取器接收，此方法應該會快速傳回，或可能會干擾播放。 請勿封鎖執行緒、等候事件，或在此方法內執行其他冗長的作業。

需求

另請參閱

IMFSampleGrabberSinkCallback