Funzione FindPreviousFrame

Articolo
06/13/2023

La funzione FindPreviousFrame trova il frame precedente nel contesto di acquisizione corrente che corrisponde al filtro.

Sintassi

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

Parametri

hCurrentFrame

Handle al frame.

ProtocolName

Nome del protocollo, ad esempio TCP.

DestinationAddress

Indirizzo di destinazione del frame che viene cercato.

SourceAddress

Indirizzo di origine del frame cercato.

ProtocolOffset

Puntatore a word che riceve l'offset del protocollo.

OriginalFrameNumber

Punto di partenza della ricerca. Per impostazione predefinita, questa funzione cerca 1.000 frame precedenti dal punto di partenza OriginalFrameNumber . È possibile modificare la distanza di ricerca aggiungendo questa riga al file Nmapi.ini, che si trova nella directory \Network Monitor.

MAXLOOKBACK=<nuova distanza di lookback>

Più bassoframe

Numero di frame più basso nell'acquisizione ricercata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il frame precedente.

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

Commenti

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

ProtocolOffset viene restituito al parser chiamante, che aggiunge questo DWORD al puntatore restituito bloccando il frame (con ParserTemporaryLockFrame) per ottenere l'LPBYTE del protocollo da cercare. In caso di ritorno, il HFRAME che ha passato il filtro viene assegnato al parser. Se il parser rileva che il frame non è quello che viene cercato, il parser può passare nuovamente alla funzione FindPreviousFrame per recuperare il frame successivo. Gli indirizzi di origine e di destinazione, che non sono necessari, possono essere passati come NULL. Se usato, questi indirizzi possono essere di tipo ADDRESS_TYPE_IP e così via, non solo i tipi MAC.

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