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=<新しいルックフォワード距離>

HighestFrame

検索されるキャプチャ内の最も大きいフレーム番号。

戻り値

関数が成功した場合、戻り値は次のフレームへのハンドルになります。

関数が成功しない場合、戻り値は NULL です。

解説

キャプチャ フィルターは、主に ProtocolName パラメーターによって定義されます。これは、唯一必要なフィルター入力です。 DestinationAddress データと SourceAddress データを追加して、キャプチャ速度を向上させることができます。

ProtocolOffset ポインターが呼び出し元パーサーに返されます。これにより、フレームをロックして (ParserTemporaryLockFrame を使用して) 返されるポインターに WORD が追加され、検索対象のプロトコルの LPBYTE が取得されます。 返されると、フィルターを渡した HFRAME がパーサーに渡されます。 パーサーが、このフレームが求められているフレームではないことを検出した場合、パーサーは HFRAME を FindNextFrame 関数に渡して次のフレームを取得できます。 送信元アドレスと宛先アドレスは必須ではなく、 NULL として渡すことができます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Netmon.h
ライブラリ	Nmapi.lib
[DLL]	Nmapi.dll