Função FindNextFrame
A função FindNextFrame localiza o próximo quadro no contexto de captura atual que corresponde ao filtro.
Sintaxe
HFRAME WINAPI FindNextFrame(
HFRAME hCurrentFrame,
LPSTR ProtocolName,
LPADDRESS DestinationAddress,
LPADDRESS SourceAddress,
LPWORD ProtocolOffset,
DWORD OriginalFrameNumber,
DWORD HighestFrame
);
Parâmetros
-
hCurrentFrame
-
Um identificador para o quadro.
-
ProtocolName
-
O nome do protocolo, como TCP.
-
DestinationAddress
-
O endereço de destino.
-
SourceAddress
-
O endereço de origem.
-
ProtocolOffset
-
Um ponteiro para um WORD que receberá o deslocamento de protocolo.
-
OriginalFrameNumber
-
O ponto de partida da pesquisa. Por padrão, essa função pesquisa 1.000 quadros do ponto de partida OriginalFrameNumber . Para alterar a distância de avanço da pesquisa, adicione essa linha ao arquivo Nmapi.ini, localizado no diretório \Network Monitor.
MAXLOOKBACK=<new lookforward distance>
-
HighestFrame
-
O número de quadros mais alto na captura pesquisada.
Valor retornado
Se a função for bem-sucedida, o valor retornado será um identificador para o próximo quadro.
Se a função não for bem-sucedida, o valor retornado será NULL.
Comentários
O filtro de captura é definido principalmente pelo parâmetro ProtocolName , que é a única entrada de filtro necessária; você pode adicionar dados DestinationAddress e SourceAddress para aumentar a velocidade de captura.
O ponteiro ProtocolOffset é retornado ao analisador de chamada, que adiciona o WORD ao ponteiro retornado bloqueando o quadro (com ParserTemporaryLockFrame) para obter o LPBYTE do protocolo pesquisado. No retorno, o HFRAME que passou o filtro é dado ao analisador. Se o analisador descobrir que esse quadro não é aquele procurado, o analisador poderá devolver o HFRAME à função FindNextFrame para obter o próximo quadro. Os endereços de origem e destino não são necessários e podem ser passados como NULL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|