FindPreviousFrame-Funktion

Die FindPreviousFrame-Funktion findet den vorherigen Frame im aktuellen Erfassungskontext, der dem Filter entspricht.

Syntax

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

Parameter

hCurrentFrame

Handle für den Frame.

ProtocolName

Protokollname, z. B. TCP.

DestinationAddress

Zieladresse des gesuchten Frames.

SourceAddress

Quelladresse des frames, nach dem gesucht wird.

ProtocolOffset

Zeiger auf ein WORD , das den Protokolloffset empfängt.

OriginalFrameNumber

Ausgangspunkt der Suche. Standardmäßig durchsucht diese Funktion 1.000 Frames rückwärts vom OriginalFrameNumber-Startpunkt . Sie können den Suchabstand ändern, indem Sie diese Zeile der Nmapi.ini-Datei hinzufügen, die sich im Verzeichnis \Network Monitor befindet.

MAXLOOKBACK=<new lookback distance>

LowestFrame

Niedrigste Framezahl in der durchsuchten Aufzeichnung.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den vorherigen Frame.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert NULL.

Bemerkungen

Der Erfassungsfilter wird in erster Linie durch ProtocolName definiert, der die einzige erforderliche Filtereingabe ist. Sie können DestinationAddress - und SourceAddress-Informationen hinzufügen, um die Erfassungsgeschwindigkeit zu erhöhen.

ProtocolOffset wird an den aufrufenden Parser zurückgegeben, der diesen DWORD dem zurückgegebenen Zeiger hinzufügt, indem der Frame (mit ParserTemporaryLockFrame) gesperrt wird, um das LPBYTE des protokolls abzurufen, nach dem gesucht wird. Bei der Rückgabe wird der HFRAME, der den Filter übergeben hat, an den Parser übergeben. Wenn der Parser feststellt, dass der Gesuchte nicht der gesuchte Frame ist, kann der Parser diesen HFRAME zurück an die FindPreviousFrame-Funktion übergeben, um den nächsten Frame abzurufen. Die nicht erforderlichen Quell- und Zieladressen können als NULL übergeben werden. Bei Verwendung können diese Adressen vom Typ ADDRESS_TYPE_IP usw. sein, nicht nur MAC-Typen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Netmon.h
Bibliothek	Nmapi.lib
DLL	Nmapi.dll