Функция FwpsPendClassify0 (fwpsk.h)

Статья
02/07/2025

Функция выноски классифицирует функциюFn вызывает FwpsPendClassify0 для отправки текущего запроса классификации. После выполнения запроса драйвер выноски должен завершить обработку запроса классификации асинхронно путем вызова FwpsCompleteClassify0.

ПримечаниеFwpsPendClassify0 — это определенная версия FwpsPendClassify. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Синтаксис

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Параметры

[in] classifyHandle

Дескриптор классификации, определяющий обработку драйвера выноски на текущем уровне. Этот дескриптор получается путем вызова FwpsAcquireClassifyHandle0.

[in] filterId

Значение элемента FilterId параметра classifyFn функции фильтра. Дополнительные сведения о элементе FilterId см. в разделе FWPS_FILTER1.

[in] flags

Зарезервировано для дальнейшего использования. Установите значение нулю.

[in, out] classifyOut

Задайте для параметра classifyOut функции драйвера выноски, классифицируемойFn. Параметр classifyOutclassifyFn указан в качестве выходного параметра в заголовке, но содержит достаточно сведений о входных данных, чтобы быть полезными для подсистемы при передаче в FwpsPendClassify.

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

Функция FwpsPendClassify0 возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Запрос классификации успешно задается.
STATUS_FWP_CANNOT_PEND	Модуль не разрешает асинхронную классификацию на уровне, из которого был выполнен вызов.
Другие коды состояния	Произошла ошибка.

Замечания

FwpsPendClassify0 помещает классификацию указанного события в забитое состояние. Драйвер выноски обычно выполняет классификацию перьев, чтобы больше обработки можно было сделать вне области функции классифицироватьFn выноски. Затем драйвер выноски может передать дескриптор классификации и любые другие соответствующие данные о указании функции с меньшим воздействием на производительность, чем функции выноски драйвера. После завершения обработки выноска должна вызвать FwpsCompleteClassify0, чтобы удалить записное состояние. Во время вызова FwpsCompleteClassify драйвер выноски должен вернуть заполненную FWPS_CLASSIFY_OUT0 структуру так же, как и в встроенной классификации.

FwpsPendClassify0 увеличивает число ссылок для дескриптора классификации, переданного в параметре classifyHandle. После вызова этой функции драйвер выноски может вызвать эту функцию. FwpsReleaseClassifyHandle0 для выпуска локального экземпляра. При вызове FwpsCompleteClassify0 ссылка на дескриптор будет отложена автоматически.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
библиотеки	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL