Funzione FwpsPendClassify0 (fwpsk.h)

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

   
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

Vedi anche

FWPS_CLASSIFY_OUT0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsCompleteClassify0

FwpsReleaseClassifyHandle0

classificazioneFn