FwpsCloneStreamData0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsCloneStreamData0--Funktion weist einen Klon eines vorhandenen FWPS_STREAM_DATA0 Datenstroms zu.

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

Syntax

NTSTATUS FwpsCloneStreamData0(
  [in, out]      FWPS_STREAM_DATA0 *calloutStreamData,
  [in, optional] NDIS_HANDLE       netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE       netBufferPoolHandle,
  [in]           ULONG             allocateCloneFlags,
  [out]          NET_BUFFER_LIST   **netBufferListChain
);

Parameter

[in, out] calloutStreamData

Ein Zeiger auf die ursprüngliche FWPS_STREAM_DATA0 Struktur, deren NET_BUFFER_LIST Struktur geklont werden soll.

[in, optional] netBufferListPoolHandle

Ein NET_BUFFER_LIST Poolhandle, das aus einem vorherigen Aufruf der NdisAllocateNetBufferListPool-Funktion abgerufen wurde. Dieser Parameter ist optional und kann NULL-werden.

[in, optional] netBufferPoolHandle

Ein NET_BUFFER Poolhandle, das von einem vorherigen Aufruf an den NdisAllocateNetBufferPool Funktion. Dieser Parameter ist optional und kann NULL-werden.

[in] allocateCloneFlags

Für diese Funktion sind derzeit keine Flags definiert. Legendentreiber sollten diesen Parameter auf Null festlegen.

[out] netBufferListChain

Ein Zeiger auf eine Position, die einen Zeiger auf eine Kette von NET_BUFFER_LIST Strukturen empfängt, die alle geklonten Datenstromdaten beschreiben.

Rückgabewert

Die funktion FwpsCloneStreamData0 gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Klon FWPS_STREAM_DATA0 Struktur wurde erfolgreich zugeordnet.
Andere Statuscodes	Fehler.

Bemerkungen

Diese geklonten Datenstromdaten können von einem Popuptreiber zu einem späteren Zeitpunkt in den TCP/IP-Netzwerkstapel eingefügt werden.

Die FwpsCloneStreamData0 Funktion klont die gesamte Kette von NET_BUFFER_LIST Strukturen, die im vorhandenen FWPS_STREAM_DATA0 Datenstrom enthalten sind. Die Funktion schneidet nicht verwendete Daten so ab, dass ein Legendentreiber die geklonte Kette erfolgreich an die geklonte Kette übergeben kann. FwpsStreamInjectAsync0 Funktion.

Nachdem Streamdaten in der Klon-NET_BUFFER_LIST Strukturkette erfolgreich in den Netzwerkstapel eingefügt wurden, wird die completionFn Legendenfunktion für jeden Klon NET_BUFFER_LIST Struktur aufgerufen, und eine Legende sollte FwpsFreeCloneNetBufferList0 aufrufen, um den Klon NET_BUFFER_LIST Struktur freizuweisen.

Eine Legende sollte die FwpsDiscardClonedStreamData0 Funktion aufrufen, wenn die geklonten Datenstromdaten verworfen werden sollen, ohne erneut ausgelöst zu werden.

Anforderungen

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