Función FindPreviousFrame

La función FindPreviousFrame busca el fotograma anterior en el contexto de captura actual que coincide con el filtro.

Sintaxis

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

Parámetros

hCurrentFrame

Identificador del marco.

ProtocolName

Nombre del protocolo, como TCP.

DestinationAddress

Dirección de destino del marco que se busca.

SourceAddress

Dirección de origen del marco que se busca.

ProtocolOffset

Puntero a un WORD que recibe el desplazamiento del protocolo.

OriginalFrameNumber

Punto de partida de la búsqueda. De forma predeterminada, esta función busca 1000 fotogramas hacia atrás desde el punto de partida OriginalFrameNumber . Puede cambiar la distancia de búsqueda hacia atrás agregando esta línea al archivo Nmapi.ini, que se encuentra en el directorio \Network Monitor.

MAXLOOKBACK=<new lookback distance>

LowestFrame

Número de fotograma más bajo de la captura que se busca.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador del marco anterior.

Si la función no se ejecuta correctamente, el valor devuelto es NULL.

Comentarios

ProtocolName define principalmente el filtro de captura, que es la única entrada de filtro necesaria; Puede agregar información de DestinationAddress y SourceAddress para aumentar la velocidad de captura.

ProtocolOffset se devuelve al analizador de llamadas, que agrega este DWORD al puntero devuelto bloqueando el marco (con ParserTemporaryLockFrame) para obtener el LPBYTE del protocolo que se está buscando. En la devolución, el HFRAME que pasó el filtro se asigna al analizador. Si el analizador encuentra que el marco no es el que se busca, el analizador puede devolver este HFRAME a la función FindPreviousFrame para recuperar el siguiente fotograma. Las direcciones de origen y destino, que no son necesarias, se pueden pasar como NULL. Cuando se usa, estas direcciones pueden ser de tipo ADDRESS_TYPE_IP, etc., no solo tipos MAC.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Biblioteca	Nmapi.lib
Archivo DLL	Nmapi.dll