Función FindNextFrame

La función FindNextFrame busca el siguiente marco en el contexto de captura actual que coincide con el filtro.

Sintaxis

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

Parámetros

hCurrentFrame

Identificador del marco.

ProtocolName

Nombre del protocolo, como TCP.

DestinationAddress

Dirección de destino.

SourceAddress

Dirección de origen.

ProtocolOffset

Puntero a un WORD que recibirá el desplazamiento del protocolo.

OriginalFrameNumber

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

MAXLOOKBACK=<new lookforward distance>

HighestFrame

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

Valor devuelto

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

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

Observaciones

El filtro de captura se define principalmente mediante el parámetro ProtocolName , que es la única entrada de filtro necesaria; Puede agregar datos DestinationAddress y SourceAddress para aumentar la velocidad de captura.

El puntero ProtocolOffset se devuelve al analizador de llamadas, que agrega word al puntero devuelto bloqueando el marco (con ParserTemporaryLockFrame) para obtener el LPBYTE del protocolo buscado. En la devolución, el HFRAME que pasó el filtro se asigna al analizador. Si el analizador encuentra que este marco no es el que se busca, el analizador puede devolver el HFRAME a la función FindNextFrame para obtener el siguiente fotograma. Las direcciones de origen y destino no son necesarias y se pueden pasar como NULL.

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