Freigeben über


FwpsCloneStreamData0-Funktion (fwpsk.h)

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

Weitere Informationen

FWPS_STREAM_DATA0

FwpsDiscardClonedStreamData0

FwpsFreeCloneNetBufferList0

FwpsStreamInjectAsync0

NET_BUFFER

NET_BUFFER_LIST