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

Статья
02/29/2024

Функция classifyFn выноски вызывает 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 функции classifyFn драйвера выноски. Параметр classifyOutклассаifyFn указан в заголовке как выходной параметр, но он содержит достаточно сведений о входных данных, чтобы быть полезным для подсистемы при передаче в FwpsPendClassify.

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 7.
Целевая платформа	Универсальное
Верхняя часть	fwpsk.h (включая Fwpsk.h)
Библиотека	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL