FindNextFrame, fonction

Article
06/13/2023

La fonction FindNextFrame recherche l’image suivante dans le contexte de capture actuel qui correspond au filtre.

Syntaxe

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

Paramètres

hCurrentFrame

Handle pour le cadre.

ProtocolName

Nom du protocole, par exemple TCP.

DestinationAddress

Adresse de destination.

SourceAddress

Adresse source.

ProtocolOffset

Pointeur vers un MOT qui recevra le décalage du protocole.

OriginalFrameNumber

Point de départ de la recherche. Par défaut, cette fonction recherche 1 000 images à partir du point de départ OriginalFrameNumber . Pour modifier la distance de recherche vers l’avant, ajoutez cette ligne au fichier Nmapi.ini, situé dans le répertoire \Network Monitor.

MAXLOOKBACK=<new lookforward distance>

HighestFrame

Nombre de cadres le plus élevé dans la capture recherchée.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour l’image suivante.

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

Notes

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

Le pointeur ProtocolOffset est retourné à l’analyseur appelant, qui ajoute le MOT au pointeur retourné en verrouillant le frame (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 trouve que ce frame n’est pas celui recherché, l’analyseur peut remettre le HFRAME à la fonction FindNextFrame pour obtenir l’image suivante. Les adresses source et de destination ne sont pas obligatoires et peuvent être passées en tant que NULL.

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