FindNextFrame 函数

FindNextFrame 函数在当前捕获上下文中查找与筛选器匹配的下一帧。

语法

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

参数

hCurrentFrame

帧的句柄。

ProtocolName

协议名称，例如 TCP。

目的地地址

目标地址。

SourceAddress

源地址。

ProtocolOffset

指向将接收协议偏移量的 WORD 的指针。

OriginalFrameNumber

搜索的起点。 默认情况下，此函数从 OriginalFrameNumber 起始点向前搜索 1，000 帧。 若要更改前向搜索距离，请将此行添加到位于 \Network Monitor 目录中的 Nmapi.ini 文件中。

MAXLOOKBACK=<新向前看距离>

HighestFrame

捕获中搜索的最高帧数。

返回值

如果函数成功，则返回值是下一帧的句柄。

如果函数不成功，则返回值为 NULL。

备注

捕获筛选器主要由 ProtocolName 参数定义，该参数是唯一所需的筛选器输入;可以添加 DestinationAddress 和 SourceAddress 数据以提高捕获速度。

ProtocolOffset 指针返回到调用分析程序，后者将 WORD 添加到返回的指针，方法是使用 ParserTemporaryLockFrame) 锁定帧 (以获取所搜索协议的 LPBYTE。 返回时，会将传递筛选器的 HFRAME 提供给分析程序。 如果分析程序发现此帧不是所查找帧，则分析程序可以将 HFRAME 交回 FindNextFrame 函数以获取下一帧。 源地址和目标地址不是必需的，可以传递为 NULL。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Netmon.h
库	Nmapi.lib
DLL	Nmapi.dll