aviStreamFindSample 函式 (vfw.h)

AVIStreamFindSample函式會傳回範例 (主要畫面格、無空框架或包含相對於指定位置之格式變更) 的框架位置。

此函式會取代過時的 AVIStreamFindKeyFrame 函式。

語法

LONG AVIStreamFindSample(
  PAVISTREAM pavi,
  LONG       lPos,
  LONG       lFlags
);

pavi

開啟資料流程的控制碼。

lPos

搜尋的起始框架。

lFlags

旗標，指定要尋找的框架類型、要搜尋之資料流程的方向，以及傳回信息的類型。定義下列旗標。

值	意義
FIND_ANY	尋找空的框架。此旗標會取代SEARCH_ANY旗標。
FIND_KEY	尋找主要畫面格。此旗標會取代SEARCH_KEY旗標。
FIND_FORMAT	尋找格式變更。
FIND_NEXT	尋找最接近的範例、框架或格式變更向前搜尋。目前範例包含在搜尋中。將此旗標與 FIND_ANY、FIND_KEY 或 FIND_FORMAT 旗標搭配使用。此旗標會取代SEARCH_FORWARD旗標。
FIND_PREV	尋找最接近的範例、框架或格式變更向後搜尋。目前範例包含在搜尋中。將此旗標與 FIND_ANY、FIND_KEY 或 FIND_FORMAT 旗標搭配使用。此旗標會取代SEARCH_NEAREST和SEARCH_BACKWARD旗標。
FIND_FROM_START	尋找從資料流程開頭開始的第一個範例、框架或格式變更。將此旗標與 FIND_ANY、FIND_KEY 或 FIND_FORMAT 旗標搭配使用。

如果搜尋失敗，則傳回找到的框架位置或 -1。

FIND_KEY、FIND_ANY和FIND_FORMAT旗標互斥，如同FIND_NEXT和FIND_PREV旗標。

引數 pavi 包含 IAVIStream 介面的指標。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	vfw.h
程式庫	Vfw32.lib
Dll	Avifil32.dll