FwpsPendClassify0-Funktion (fwpsk.h)

Die KlassifizierungFn-Funktion eines Legendes ruft FwpsPendClassify0 auf, um die aktuelle Klassifizierungsanforderung zu schreiben. Nachdem die Anforderung pended wurde, muss der Legendentreiber die Verarbeitung der Klassifizierungsanforderung asynchron abschließen, indem FwpsCompleteClassify0 aufgerufen wird.

HinweisFwpsPendClassify0 ist eine bestimmte Version von FwpsPendClassify. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Für bestimmte Versionen von Windows .
 

Syntax

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

Parameter

[in] classifyHandle

Der Klassifizierungshandpunkt, der die Verarbeitung des Legendentreibers auf der aktuellen Ebene identifiziert. Dieser Handle wird durch Aufrufen abgerufen. FwpsAcquireClassifyHandle0.

[in] filterId

Der Wert des FilterId-Members des Filterparameters der KlassifizierungFn-Funktion. Weitere Informationen zum FilterId-Element finden Sie unter FWPS_FILTER1.

[in] flags

Für die zukünftige Verwendung reserviert. Auf NULL festlegen.

[in, out] classifyOut

Legen Sie auf den Klassifikationsparameter der KlassifizierungFn-Funktion des Legendentreibers fest. Der klassifizierenOut-Parameter der KlassifizierungFn wird als Ausgabeparameter im Header aufgeführt, enthält jedoch genügend Informationen zur Eingabe, die für das Modul nützlich sein können, wenn sie an FwpsPendClassify übergeben werden.

Rückgabewert

Die Funktion FwpsPendClassify0 gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode Beschreibung
STATUS_SUCCESS
Die Klassifizierungsanforderung wurde erfolgreich eingestiftet.
STATUS_FWP_CANNOT_PEND
Das Modul erlaubt keine asynchrone Klassifizierung auf der Ebene, aus der der Aufruf getätigt wurde.
Andere Statuscodes
Ein Fehler ist aufgetreten.

Bemerkungen

FwpsPendClassify0 platziert die Klassifizierung des angegebenen Ereignisses in einen stifteten Zustand. Ein Legendentreiber gibt in der Regel eine Stiftklassifizierung an, sodass eine weitere Verarbeitung außerhalb des Bereichs der KlassifizierenFn-Legendenfunktion erfolgen kann. Der Legendentreiber kann dann den Klassifizierungshandpunkt und alle anderen relevanten Daten über die Angabe an eine Funktion übergeben, die weniger Auswirkungen auf die Leistung hat als die Treiber-Legendenfunktionen. Wenn die Verarbeitung abgeschlossen ist, muss die Legende FwpsCompleteClassify0 aufrufen, um den Stiftstatus zu entfernen. Zum Zeitpunkt des Aufrufs von FwpsCompleteClassify muss der Legendentreiber eine ausgefüllte FWPS_CLASSIFY_OUT0 Struktur wie in einer Inlineklassifizierung zurückgeben.

FwpsPendClassify0 erhöht die Referenzanzahl für den klassifizierungshandle-Parameter übergebenen Klassifizierungshandle . Nachdem der Legendentreiber diese Funktion aufgerufen hat, kann er aufrufen. FwpsReleaseClassifyHandle0 zum Freigeben der lokalen Instanz. Wenn FwpsCompleteClassify0 aufgerufen wird, wird der Verweis auf das Handle automatisch erhöht.

Anforderungen

   
Unterstützte Mindestversion (Client) Ab Windows 7 verfügbar.
Zielplattform Universell
Header fwpsk.h (include Fwpsk.h)
Bibliothek Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

FWPS_CLASSIFY_OUT0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsCompleteClassify0

FwpsReleaseClassifyHandle0

klassifizierenFn