NdisIMCopySendPerPacketInfo-Funktion (ndis.h)
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.
NdisIMCopySendPerPacketInfo kopiert informationen pro Paket aus einem Paket, das von einem Treiber auf oberster Ebene in ein neues Paket gesendet wurde, um an einen niedrigeren Miniporttreiber gesendet zu werden.
Syntax
void NdisIMCopySendPerPacketInfo(
[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 eine Sendeanforderung von einem Treiber der oberen Ebene an einen niedrigeren Miniporttreiber weiterleitet, ruft dieser Zwischentreiber NdisIMCopySendPerPacketInfo auf, um informationen pro Paket zu kopieren. Der Zwischentreiber kopiert die Informationen pro Paket von einem Paket, das vom Treiber der oberen Ebene nach unten gesendet wird, in ein neues Paket, das der Zwischentreiber an den unteren Miniporttreiber sendet. Der Zwischentreiber ruft NdisIMCopySendPerPacketInfo für jedes Paket, das über den Stapel gesendet 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 |