FwpsCloneStreamData0-Funktion (fwpsk.h)

Artikel
02/29/2024

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 Zielgruppenspezifische Windows-Versionen .

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 von einem vorherigen Aufruf der NdisAllocateNetBufferListPool-Funktion abgerufen wurde. Dieser Parameter ist optional und kann NULL sein.

[in, optional] netBufferPoolHandle

Ein NET_BUFFER Poolhandle, das aus einem vorherigen Aufruf des abgerufen wurde NdisAllocateNetBufferPool-Funktion . Dieser Parameter ist optional und kann NULL sein.

[in] allocateCloneFlags

Für diese Funktion sind derzeit keine Flags definiert. Legendentreiber sollten diesen Parameter auf 0 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 FwpsCloneStreamData0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Klonstruktur FWPS_STREAM_DATA0 wurde erfolgreich zugeordnet.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Diese geklonten Datenstromdaten können zu einem späteren Zeitpunkt von einem Legendentreiber 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 fwpsStreamInjectAsync0-Funktion .

Nachdem Streamdaten in der Klon-NET_BUFFER_LIST Strukturkette erfolgreich in den Netzwerkstapel eingefügt wurden, wird die CompletionFn-Calloutfunktion für jeden Klon NET_BUFFER_LIST Struktur aufgerufen, und eine Legende sollte FwpsFreeCloneNetBufferList0 aufrufen, um den Klon NET_BUFFER_LIST Struktur frei zu geben.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Universell
Header	fwpsk.h (include fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL