Funzione NdisIMCopySendPerPacketInfo (ndis.h)
Nota NDIS 5. x è stato deprecato e sostituito da NDIS 6. x. Per i nuovi driver NDIS, vedere Driver di rete a partire da Windows Vista. Per informazioni sulla conversione di NDIS 5. driver x a NDIS 6. x, vedere Porting NDIS 5.x Drivers to NDIS 6.0.
NdisIMCopySendPerPacketInfo copia le informazioni per pacchetto da un pacchetto inviato da un driver di livello superiore in un nuovo pacchetto da inviare a un driver miniport inferiore.
Sintassi
void NdisIMCopySendPerPacketInfo(
[out] OUT PNDIS_PACKET DstPacket,
[in] IN PNDIS_PACKET SrcPacket
);
Parametri
[out] DstPacket
Puntatore al descrittore di pacchetti di destinazione in cui copiare le informazioni per pacchetto.
[in] SrcPacket
Puntatore al descrittore del pacchetto di origine da cui vengono copiate informazioni per pacchetto.
Valore restituito
Nessuno
Osservazioni
Quando un driver intermedio inoltra una richiesta di invio da un driver di livello superiore a un driver miniport inferiore, tale driver intermedio chiama NdisIMCopySendPerPacketInfo per copiare informazioni per pacchetto. Il driver intermedio copia le informazioni per pacchetto da un pacchetto inviato dal driver di livello superiore in un nuovo pacchetto inviato dal driver intermedio al driver miniport inferiore. Il driver intermedio chiama NdisIMCopySendPerPacketInfo per ogni pacchetto inviato attraverso lo stack, a meno che il driver intermedio non debba modificare le informazioni per pacchetto di un pacchetto.
Le informazioni per pacchetto sono contenute in una struttura NDIS_PACKET_EXTENSION e includono, ad esempio, informazioni di checksum, informazioni sulla sicurezza del protocollo Internet e informazioni sulla priorità 802.1p.
Se un driver intermedio deve modificare le informazioni per pacchetto di un pacchetto, tale driver intermedio deve utilizzare la macro NDIS_PER_PACKET_INFO_FROM_PACKET per accedere alle informazioni. Il driver può chiamare questa macro una volta per ogni tipo di informazioni per pacchetto a cui deve accedere.
I driver possono anche utilizzare la macro NDIS_PACKET_EXTENSION_FROM_PACKET, che restituisce un puntatore alla struttura NDIS_PACKET_EXTENSION. Un driver può chiamare questa macro se deve accedere a più tipi di informazioni per pacchetto associate a un descrittore di pacchetti. Dopo aver ottenuto il puntatore alla struttura NDIS_PACKET_EXTENSION, il driver può usare l'indice di matrice appropriato per ottenere un puntatore a un determinato tipo di informazioni per pacchetto.
Per copiare un intervallo di dati da un pacchetto a un altro, usare la funzioneNdisCopyFromPacketToPacket.
- Piattaforma di destinazione: universal
- Versione: non supportata per i driver NDIS 6.0 in Windows Vista. Supportato per i driver NDIS 5.1 in Windows Vista e Windows XP.
Fabbisogno
Requisito | Valore |
---|---|
intestazione | ndis.h (include Ndis.h) |
libreria | Ndis.lib |
IRQL | Qualsiasi livello |