FindPreviousFrame 函式

FindPreviousFrame函式會在符合篩選準則的目前擷取內容中尋找上一個框架。

語法

HFRAME WINAPI FindPreviousFrame(
   HFRAME    hCurrentFrame,
   LPSTR     ProtocolName,
   LPADDRESS DestinationAddress,
   LPADDRESS SourceAddress,
   LPWORD    ProtocolOffset,
   DWORD     OriginalFrameNumber,
   DWORD     LowestFrame
);

參數

hCurrentFrame

框架的控制碼。

ProtocolName

通訊協定名稱，例如 TCP。

DestinationAddress

搜尋之框架的目的地位址。

SourceAddress

所搜尋框架的來源位址。

ProtocolOffset

接收通訊協定位移之 WORD 的指標。

OriginalFrameNumber

搜尋的起點。 根據預設，此函式會從 OriginalFrameNumber 起點搜尋回溯 1，000 個畫面格。 您可以將這一行新增至位於 \Network Monitor 目錄中的 Nmapi.ini 檔案，以變更搜尋回距離。

MAXLOOKBACK= < 新的回溯距離>

LowestFrame

搜尋的擷取中最低框架編號。

傳回值

如果函式成功，則傳回值是上一個框架的控制碼。

如果函式未成功，則傳回值為 Null。

備註

擷取篩選主要是由 ProtocolName定義，這是唯一必要的篩選輸入;您可以新增 DestinationAddress 和 SourceAddress 資訊，以提高擷取速度。

ProtocolOffset 會傳回至呼叫的剖析器，它會將這個 DWORD 新增至指標，方法是使用 ParserTemporaryLockFrame) 鎖定框架 (來取得所搜尋通訊協定的 LPBYTE。 傳回時，傳遞篩選準則的 HFRAME 會提供給剖析器。 如果剖析器發現框架不是所要尋找的框架，剖析器可以將此 HFRAME 交回 FindPreviousFrame 函式，以擷取下一個框架。 不需要的來源和目的地位址可以傳遞為 Null。 使用時，這些位址可以是類型ADDRESS_TYPE_IP等等，而不只是 MAC 類型。

規格需求