Freigeben über

NdisIMCopySendCompletePerPacketInfo-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x ist veraltet und wird von NDIS 6 ersetzt. x. Informationen zur neuen NDIS-Treiberentwicklung finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber auf NDIS 6. xfinden Sie unter Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisIMCopySendCompletePerPacketInfo kopiert informationen pro Paket von einem Paket, das von einem niedrigeren Miniporttreiber zurückgegeben wird, in ein neues Paket, das an einen Treiber der oberen Ebene zurückgegeben werden soll.

Syntax

void NdisIMCopySendCompletePerPacketInfo(
  [out] OUT PNDIS_PACKET DstPacket,
  [in]  IN PNDIS_PACKET  SrcPacket
);

Parameter

[out] DstPacket

Zeiger auf den Zielpaketdeskriptor, in den pro Paket informationen kopiert werden sollen.

[in] SrcPacket

Zeiger auf den Quellpaketdeskriptor, aus dem paketbezogene Informationen kopiert werden.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Zwischentreiber den Abschluss einer Sendeanforderung von einem niedrigeren Miniporttreiber verarbeitet, ruft dieser Zwischentreiber NdisIMCopySendCompletePerPacketInfo auf, um informationen pro Paket zu kopieren. Der Zwischentreiber kopiert die Informationen pro Paket aus einem Paket, das vom unteren Miniporttreiber zurückgegeben wurde, in ein neues Paket, das der Zwischentreiber zu einem Treiber auf oberster Ebene zurückgibt. Der Zwischentreiber ruft NdisIMCopySendCompletePerPacketInfo- für jedes paket, das über den Stapel zurückgegeben wird, auf, es sei denn, der Zwischentreiber muss die Informationen pro Paket ändern.

Paketbezogene Informationen sind in einer NDIS_PACKET_EXTENSION Struktur enthalten und umfassen z. B. Prüfsummeninformationen, Internetprotokollsicherheitsinformationen und 802.1p-Prioritätsinformationen.

Wenn ein Zwischentreiber die Informationen pro Paket ändern muss, sollte dieser Zwischentreiber das NDIS_PER_PACKET_INFO_FROM_PACKET Makro verwenden, um auf die Informationen zuzugreifen. Der Treiber kann dieses Makro einmal für jeden Pakettyp aufrufen, auf den es zugreifen muss.

Treiber können auch das NDIS_PACKET_EXTENSION_FROM_PACKET-Makro verwenden, das einen Zeiger auf die NDIS_PACKET_EXTENSION Struktur zurückgibt. Ein Treiber kann dieses Makro aufrufen, wenn er auf mehrere Typen von Paketinformationen zugreifen muss, die einem Paketdeskriptor zugeordnet sind. Nach dem Abrufen des Zeigers auf die NDIS_PACKET_EXTENSION-Struktur kann der Treiber den entsprechenden Arrayindex verwenden, um einen Zeiger auf einen bestimmten Typ von Paketinformationen abzurufen.

Um einen Datenbereich von einem Paket in ein anderes zu kopieren, verwenden Sie die NdisCopyFromPacketToPacketToPacket-Funktion.

  • Zielplattform: universelle
  • Version: Für NDIS 6.0-Treiber in Windows Vista nicht unterstützt. Unterstützt für NDIS 5.1-Treiber in Windows Vista und Windows XP.

Anforderungen

Anforderung Wert
Header- ndis.h (include Ndis.h)
Library Ndis.lib
IRQL- Beliebige Ebene

Siehe auch