Поделиться через

Функция FindNextFrame

  • Статья

Функция FindNextFrame находит следующий кадр в текущем контексте записи, соответствующий фильтру.

Синтаксис

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

Параметры

hCurrentFrame

Дескриптор кадра.

ProtocolName

Имя протокола, например TCP.

DestinationAddress

Адрес назначения.

SourceAddress

Исходный адрес.

ProtocolOffset

Указатель на word , который получит смещение протокола.

OriginalFrameNumber

Начальная точка поиска. По умолчанию эта функция выполняет поиск вперед 1000 кадров из начальной точки OriginalFrameNumber . Чтобы изменить расстояние для прямого поиска, добавьте эту строку в файл Nmapi.ini, расположенный в каталоге \Network Monitor.

MAXLOOKBACK=<новое расстояние поиска>

Самый высокий кадр

Самый высокий номер кадра в записи, по которому выполняется поиск.

Возвращаемое значение

Если функция выполнена успешно, возвращается дескриптор следующего кадра.

Если функция не выполнена успешно, возвращается значение NULL.

Комментарии

Фильтр записи определяется главным образом параметром ProtocolName , который является единственным обязательным входным параметром фильтра; Вы можете добавить данные DestinationAddress и SourceAddress , чтобы увеличить скорость записи.

Указатель ProtocolOffset возвращается в вызывающий синтаксический анализатор, который добавляет WORD в указатель, возвращаемый путем блокировки кадра (с помощью ParserTemporaryLockFrame), чтобы получить LPBYTE искомого протокола. При возврате HFRAME, который передал фильтр, передается синтаксическому анализатору. Если средство синтаксического анализа обнаруживает, что этот кадр не является запрошенным, средство синтаксического анализа может передать HFRAME обратно в функцию FindNextFrame , чтобы получить следующий кадр. Исходный и целевой адреса не являются обязательными и могут быть переданы как NULL.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Netmon.h
Библиотека
Nmapi.lib
DLL
Nmapi.dll