FindNextFrame 函式

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

語法

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

參數

hCurrentFrame

框架的控制碼。

ProtocolName

通訊協定名稱，例如 TCP。

DestinationAddress

目的地位址。

SourceAddress

來源位址。

ProtocolOffset

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

OriginalFrameNumber

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

MAXLOOKBACK= < new lookforward distance>

HighestFrame

所搜尋擷取中的最高畫面編號。

傳回值

如果函式成功，則傳回值是下一個畫面格的控制碼。

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

備註

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

ProtocolOffset指標會傳回給呼叫的剖析器，這會藉由鎖定框架 (與ParserTemporaryLockFrame) 來將WORD新增至指標，以取得搜尋之通訊協定的LPBYTE。 傳回時，傳遞篩選準則的 HFRAME 會提供給剖析器。 如果剖析器發現此框架不是所要的框架，剖析器可以將 HFRAME 交回 FindNextFrame 函式，以取得下一個畫面。 來源和目的地位址並非必要，而且可以傳遞為 Null。

規格需求