Fonction FindPreviousFrame

Article
06/13/2023

La fonction FindPreviousFrame recherche l’image précédente dans le contexte de capture actuel qui correspond au filtre.

Syntaxe

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

Paramètres

hCurrentFrame

Gérer le cadre.

ProtocolName

Nom du protocole, tel que TCP.

DestinationAddress

Adresse de destination du cadre recherché.

SourceAddress

Adresse source du cadre recherché.

ProtocolOffset

Pointeur vers un MOT qui reçoit le décalage de protocole.

OriginalFrameNumber

Point de départ de la recherche. Par défaut, cette fonction recherche vers l’arrière 1 000 images à partir du point de départ OriginalFrameNumber . Vous pouvez modifier la distance de recherche en arrière en ajoutant cette ligne au fichier Nmapi.ini, qui se trouve dans le répertoire \Network Monitor.

MAXLOOKBACK=<nouvelle distance de recherche>

LowestFrame

Nombre d’images le plus bas dans la capture recherchée.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de l’image précédente.

Si la fonction échoue, la valeur de retour est NULL.

Notes

Le filtre de capture est défini principalement par ProtocolName, qui est la seule entrée de filtre requise ; vous pouvez ajouter des informations DestinationAddress et SourceAddress pour augmenter la vitesse de capture.

ProtocolOffset est retourné à l’analyseur appelant, qui ajoute ce DWORD au pointeur retourné en verrouillant l’image (avec ParserTemporaryLockFrame) pour obtenir le LPBYTE du protocole recherché. Au retour, le HFRAME qui a passé le filtre est donné à l’analyseur. Si l’analyseur constate que l’image n’est pas celle qui est recherchée, l’analyseur peut remettre cette image HFRAME à la fonction FindPreviousFrame pour récupérer l’image suivante. Les adresses source et de destination, qui ne sont pas obligatoires, peuvent être transmises en tant que NULL. Lorsqu’elles sont utilisées, ces adresses peuvent être de type ADDRESS_TYPE_IP, et ainsi de suite, pas seulement les types MAC.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h
Bibliothèque	Nmapi.lib
DLL	Nmapi.dll

Partager via