Função FindPreviousFrame

A função FindPreviousFrame localiza o quadro anterior no contexto de captura atual que corresponde ao filtro.

Sintaxe

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

Parâmetros

hCurrentFrame

Manipule para o quadro.

ProtocolName

Nome do protocolo, como TCP.

DestinationAddress

Endereço de destino do quadro pesquisado.

SourceAddress

Endereço de origem do quadro pesquisado.

ProtocolOffset

Ponteiro para um WORD que recebe o deslocamento de protocolo.

OriginalFrameNumber

Ponto de partida da pesquisa. Por padrão, essa função pesquisa 1.000 quadros anteriores do ponto de partida OriginalFrameNumber . Você pode alterar a distância de pesquisa ao adicionar essa linha ao arquivo Nmapi.ini, que está localizado no diretório \Network Monitor.

MAXLOOKBACK=<nova distância de lookback>

LowerFrame

Número de quadro mais baixo na captura pesquisada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para o quadro anterior.

Se a função não for bem-sucedida, o valor retornado será NULL.

Comentários

O filtro de captura é definido principalmente por ProtocolName, que é a única entrada de filtro necessária; você pode adicionar informações de DestinationAddress e SourceAddress para aumentar a velocidade de captura.

ProtocolOffset é retornado ao analisador de chamada, que adiciona esse DWORD ao ponteiro retornado bloqueando o quadro (com ParserTemporaryLockFrame) para obter o LPBYTE do protocolo que está sendo pesquisado. No retorno, o HFRAME que passou o filtro é dado ao analisador. Se o analisador descobrir que o quadro não é aquele que está sendo procurado, o analisador poderá devolver esse HFRAME à função FindPreviousFrame para recuperar o próximo quadro. Os endereços de origem e destino, que não são necessários, podem ser passados como NULL. Quando usados, esses endereços podem ser do tipo ADDRESS_TYPE_IP e assim por diante, não apenas tipos MAC.

Requisitos