共用方式為

IAsyncReader：：SyncReadAligned 方法 (strmif.h)

  • 發行項

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]

方法 SyncReadAligned 會執行同步讀取。 方法會封鎖直到要求完成為止。 檔案位置和緩衝區位址必須對齊;請檢查配置器屬性，以取得必要的對齊方式。

語法

HRESULT SyncReadAligned(
  IMediaSample *pSample
);

參數

pSample

呼叫端所提供之媒體範例 之 IMediaSample 介面的指標。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 Description
VFW_E_BADALIGN
 無效的對齊方式。
S_FALSE
 擷取的位元組少於要求的位元組。 (可能到達檔案的結尾。)
S_OK
 成功。

備註

呼叫這個方法之前，請先從針腳的配置器擷取媒體範例。 時間戳您要求的位元組位移範例，第一個和最後一個包含，乘以10,000,000。 位元組位移相對於數據流的開頭。

開始和停止位置應該符合接腳連接時所決定的對齊方式。 否則，方法會傳回VFW_E_BADALIGN。 如果同意的對齊方式比數據流的實際對齊方式更粗略，則停止位置可能會超過實際持續時間。 如果是，此方法會將停止位置向下四捨五入為實際的對齊方式。

這個方法會執行未緩衝讀取，因此可能比 IAsyncReader：：SyncRead 方法快。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IAsyncReader 介面