FwpsPendClassify0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die klassifizierenFn Funktion eines Popups ruft FwpsPendClassify0 auf, um die aktuelle Klassifizierungsanforderung einzuordnen. Nach dem Stift der Anforderung muss der Popuptreiber die Verarbeitung der Klassifizierungsanforderung asynchron abschließen, indem FwpsCompleteClassify0aufgerufen wird.

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

Syntax

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

Parameter

[in] classifyHandle

Das Klassifizierungshandle, das die Verarbeitung des Popuptreibers auf der aktuellen Ebene identifiziert. Dieses Handle wird durch Aufrufen abgerufen. FwpsAcquireClassifyHandle0.

[in] filterId

Der Wert des FilterId Member des klassifizierenFnFilterparameters der Funktion. Weitere Informationen zum element FilterId finden Sie unter FWPS_FILTER1.

[in] flags

Reserviert für die zukünftige Verwendung. Auf Null festgelegt.

[in, out] classifyOut

Legen Sie den klassifizierenOut Parameter der klassifizierenFn-Funktion des Popuptreibers fest. Der klassifizierenOut Parameter von klassifizierenFn wird als Ausgabeparameter im Header aufgeführt, enthält jedoch genügend Informationen zur Eingabe, die für das Modul nützlich sind, wenn sie an FwpsPendClassifyübergeben wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Klassifizierungsanforderung wurde erfolgreich eingestiftet.
STATUS_FWP_CANNOT_PEND	Das Modul lässt keine asynchrone Klassifizierung auf der Ebene zu, von der der Aufruf getätigt wurde.
Andere Statuscodes	Fehler.

Bemerkungen

FwpsPendClassify0 die Klassifizierung des angegebenen Ereignisses in einen Stiftzustand versetzt. Ein Popuptreiber wird in der Regel mit Stiften klassifiziert, sodass außerhalb des Bereichs der klassifizierenFn Legendenfunktion mehr Verarbeitung durchgeführt werden kann. Der Beschriftungstreiber kann dann den Klassifizierungshandle und alle anderen relevanten Daten über die Anzeige an eine Funktion übergeben, die weniger Auswirkungen auf die Leistung hat als die Beschriftungsfunktionen des Treibers. Wenn die Verarbeitung abgeschlossen ist, muss die Legende FwpsCompleteClassify0- aufrufen, um den Stiftstatus zu entfernen. Zum Zeitpunkt des Aufrufs von FwpsCompleteClassify muss der Popuptreiber eine ausgefüllte FWPS_CLASSIFY_OUT0 Struktur wie in einer Inlineklassifizierung zurückgeben.

FwpsPendClassify0 erhöht die Referenzanzahl für das Klassifizierungshandle, das im classificationHandle Parameter übergeben wird. Nachdem der Legendentreiber diese Funktion aufgerufen hat, kann sie aufgerufen werden. FwpsReleaseClassifyHandle0, um die lokale Instanz freizugeben. Wenn FwpsCompleteClassify0 aufgerufen wird, wird der Verweis auf das Handle automatisch erhöht.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 7.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	<= DISPATCH_LEVEL