Função FwpsPendClassify0 (fwpsk.h)

Artigo
08/07/2023

A função classifyFn de um texto explicativo chama FwpsPendClassify0 para aguardar a solicitação de classificação atual. Depois que a solicitação estiver pendente, o driver de texto explicativo deverá concluir o processamento da solicitação de classificação de forma assíncrona chamando FwpsCompleteClassify0.

ObservaçãoFwpsPendClassify0 é uma versão específica do FwpsPendClassify. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Sintaxe

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

Parâmetros

[in] classifyHandle

O identificador de classificação que identifica o processamento do driver de texto explicativo na camada atual. Esse identificador é obtido chamando FwpsAcquireClassifyHandle0.

[in] filterId

O valor do membro FilterId do parâmetro de filtro da função classifyFn. Para obter mais informações sobre o membro FilterId , consulte FWPS_FILTER1.

[in] flags

Reservado para uso futuro. Defina como zero.

[in, out] classifyOut

Defina como o parâmetro classifyOut da função classifyFn do driver de texto explicativo. O parâmetro classifyOut de classifyFn é listado como um parâmetro de saída no cabeçalho, mas contém informações suficientes sobre a entrada para ser útil para o mecanismo quando passado para FwpsPendClassify.

Retornar valor

A função FwpsPendClassify0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	A solicitação de classificação foi pendente com êxito.
STATUS_FWP_CANNOT_PEND	O mecanismo não permite a classificação assíncrona na camada da qual a chamada foi feita.
Outros códigos status	Ocorreu um erro.

Comentários

FwpsPendClassify0 coloca a classificação do evento indicado em um estado pendente. Um driver de texto explicativo normalmente aguarda a classificação para que mais processamento possa ser feito fora do escopo da função de texto explicativo classifyFn . Em seguida, o driver de texto explicativo pode passar o identificador de classificação e quaisquer outros dados pertinentes sobre a indicação para uma função com menos impacto no desempenho do que as funções de texto explicativo do driver. Quando o processamento for concluído, o texto explicativo deverá chamar FwpsCompleteClassify0 para remover o estado pendente. No momento da chamada para FwpsCompleteClassify, o driver de texto explicativo deve retornar uma estrutura de FWPS_CLASSIFY_OUT0 preenchida da mesma forma que faria em uma classificação embutida.

FwpsPendClassify0 incrementa a contagem de referência para o identificador de classificação passado no parâmetro classifyHandle . Depois que o driver de texto explicativo chamar essa função, ele poderá chamar FwpsReleaseClassifyHandle0 para liberar a instância local. Quando FwpsCompleteClassify0 for chamado, a referência ao identificador será decrementada automaticamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 7.
Plataforma de Destino	Universal
Cabeçalho	fwpsk.h (inclua Fwpsk.h)
Biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL