Funzione FwpsPendClassify0 (fwpsk.h)

Articolo
08/07/2023

Una funzione di classificazionefn di un callout chiama FwpsPendClassify0 per pennare la richiesta di classificazione corrente. Dopo aver eseguito la penna della richiesta, il driver di callout deve completare l'elaborazione della richiesta di classificazione in modo asincrono chiamando FwpsCompleteClassify0.

NotaFwpsPendClassify0 è una versione specifica di FwpsPendClassify. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Sintassi

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

Parametri

[in] classifyHandle

Handle di classificazione che identifica l'elaborazione del driver di callout al livello corrente. Questo handle viene ottenuto chiamando FwpsAcquireClassifyHandle0.

[in] filterId

Valore del membro FilterId del parametro filterFn della funzione di classificazione. Per altre informazioni sul membro FilterId , vedere FWPS_FILTER1.

[in] flags

Riservato per utilizzi futuri. Imposta su zero.

[in, out] classifyOut

Impostare sul parametro di classificazioneOut della funzione classificazioneFn del driver di callout. Il parametro di classificazioneFn è elencato come parametro di output nell'intestazione, ma contiene informazioni sufficienti sull'input da usare per il motore quando passato a FwpsPendClassify.

Valore restituito

La funzione FwpsPendClassify0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La richiesta di classificazione è stata eseguita correttamente.
STATUS_FWP_CANNOT_PEND	Il motore non consente la classificazione asincrona a livello da cui è stata effettuata la chiamata.
Altri codici di stato	Si è verificato un errore.

Commenti

FwpsPendClassify0 inserisce la classificazione dell'evento indicato in uno stato penna. Una classificazione del driver di callout in genere penna in modo che sia possibile eseguire più elaborazione all'esterno dell'ambito della funzione di callout di classificazioneFn . Il driver di callout può quindi passare l'handle di classificazione e qualsiasi altro dato pertinente sull'indicazione a una funzione con un impatto minore sulle prestazioni rispetto alle funzioni di callout del driver. Al termine dell'elaborazione, il callout deve chiamare FwpsCompleteClassify0 per rimuovere lo stato penna. Al momento della chiamata a FwpsCompleteClassify, il driver di callout deve restituire una struttura di FWPS_CLASSIFY_OUT0 compilata proprio come in una classificazione inline.

FwpsPendClassify0 incrementa il conteggio dei riferimenti per l'handle di classificazione passato nel parametro classificationHandle . Dopo che il driver di callout chiama questa funzione, può chiamare FwpsReleaseClassifyHandle0 per rilasciare l'istanza locale. Quando fwpsCompleteClassify0 viene chiamato, il riferimento all'handle verrà decrementato automaticamente.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 7.
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (includere Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL