Funzione FindNextFrame

Articolo
06/13/2023

La funzione FindNextFrame trova il frame successivo nel contesto di acquisizione corrente che corrisponde al filtro.

Sintassi

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

Parametri

hCurrentFrame

Handle al frame.

ProtocolName

Nome del protocollo, ad esempio TCP.

DestinationAddress

Indirizzo di destinazione.

SourceAddress

Indirizzo di origine.

ProtocolOffset

Puntatore a word che riceverà l'offset del protocollo.

OriginalFrameNumber

Punto iniziale della ricerca. Per impostazione predefinita, questa funzione cerca 1.000 frame dal punto di partenza OriginalFrameNumber . Per modificare la distanza di ricerca, aggiungere questa riga al file Nmapi.ini, disponibile nella directory \Network Monitor.

MAXLOOKBACK=<nuova distanza lookforward>

MassimoFrame

Numero di frame più alto nell'acquisizione ricercato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle al frame successivo.

Se la funzione non ha esito positivo, il valore restituito è NULL.

Commenti

Il filtro di acquisizione viene definito principalmente dal parametro ProtocolName , ovvero l'unico input di filtro richiesto; è possibile aggiungere dati DestinationAddress e SourceAddress per aumentare la velocità di acquisizione.

Il puntatore ProtocolOffset viene restituito al parser chiamante, che aggiunge word al puntatore restituito bloccando il frame (con ParserTemporaryLockFrame) per ottenere l'LPBYTE del protocollo cercato. In caso di ritorno, il HFRAME che ha passato il filtro viene assegnato al parser. Se il parser rileva che questa cornice non è quella ricercata, il parser può passare nuovamente alla funzione HFRAME per ottenere il frame successivo. Gli indirizzi di origine e di destinazione non sono obbligatori e possono essere passati come NULL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h
Libreria	Nmapi.lib
DLL	Nmapi.dll

Condividi tramite