REMOTE_NDIS_PACKET_MSG

REMOTE_NDIS_PACKET_MSG NDIS-gegevenspakketten inkapselt om één gegevensbericht te vormen.

Het samenvoegen van meerdere REMOTE_NDIS_PACKET_MSG elementen vormt een multipacketbericht. Elk afzonderlijk REMOTE_NDIS_PACKET_MSG onderdeel wordt samengesteld zoals hieronder wordt beschreven. Het verschil met het bericht met één pakket is dat het veld MessageLength in elke REMOTE_NDIS_PACKET_MSG koptekst enkele extra opvullingsbytes bevat. Deze opvullingsbytes worden toegevoegd aan alle behalve de laatste REMOTE_NDIS_PACKET_MSG, zodat de geslaagde REMOTE_NDIS_PACKET_MSG begint bij een geschikte bytegrens. Voor berichten die vanaf het apparaat naar de host worden verzonden, moet deze opvulling resulteren in elke REMOTE_NDIS_PACKET_MSG beginnen bij een byte-offset die begint met een veelvoud van 8 bytes vanaf het begin van het multipacket-bericht. Wanneer de host een multipacket-bericht naar het apparaat verzendt, voldoet deze aan de PacketAlignmentFactor die het apparaat opgeeft.

De REMOTE_NDIS_PACKET_MSG-indeling wordt gedefinieerd in de volgende tabel.

Afstand	Grootte	Veld	Beschrijving
0	4	MessageType	Hiermee geeft u het type bericht dat wordt verzonden. Ingesteld op 0x1.
4	4	MessageLength	Berichtlengte in bytes, waaronder toegevoegde pakketgegevens, OOB-gegevens, gegevens per pakket en zowel interne als externe opvulling.
8	4	DataOffset	Hiermee geeft u de offset in bytes vanaf het begin van het veld DataOffset van dit bericht tot aan het begin van de gegevens. Dit is een geheel getal van 4.
12	4	DataLength	Hiermee geeft u het aantal bytes in de gegevensinhoud van dit bericht op.
16	4	OOBDataOffset	Hiermee geeft u de offset in bytes van de eerste OOB-gegevensrecord vanaf het begin van het DataOffset veld van dit bericht. Ingesteld op nul als er geen OOB-gegevens zijn. Anders is dit een geheel getal van 4.
20	4	OOBDataLength	Hiermee geeft u op in bytes de totale lengte van de OOB-gegevens.
24	4	NumOOBDataElements	Hiermee geeft u het aantal OOB-records in dit bericht.
28	4	PerPacketInfoOffset	Hiermee geeft u op in bytes de verschuiving vanaf het begin van het DataOffset veld in het REMOTE_NDIS_PACKET_MSG gegevensbericht tot het begin van de eerste gegevensrecord per pakket. Ingesteld op nul als er geen gegevens per pakket zijn. Anders is dit een geheel getal van 4.
32	4	PerPacketInfoLength	Hiermee geeft u op in bytes de totale lengte van de gegevens per pakket in dit bericht.
36	4	VcHandle	Gereserveerd voor verbindingsgeoriënteerde apparaten. Ingesteld op nul.
40	4	Gereserveerd	Gereserveerd. Ingesteld op nul.

De indeling van één OOB-gegevensrecord wordt aangegeven in de volgende tabel.

Afstand	Grootte	Veld	Beschrijving
0	4	Grootte	Lengte in bytes van deze OOB-header en toegevoegde OOB-gegevens en opvulling. Dit is een geheel getal van 4.
4	4	Type	Geen gedefinieerd voor 802.3-apparaten.
8	4	ClassInformationOffset	De byte-offset van het begin van deze OOB-gegevensrecord tot het begin van de OOB-gegevens.
(N)	...	OOB-gegevens	OOB-gegevens; raadpleeg de documentatie van Microsoft Windows Driver Development Kit (DDK) voor meer informatie.

Opmerking (N) gelijk is aan de waarde van ClassInformationOffset-.

In de volgende tabel wordt de indeling van een gegevensrecord per pakket gedefinieerd.

Afstand	Grootte	Veld	Beschrijving
0	4	Grootte	Lengte in bytes van deze header per pakket en toegevoegde gegevens per pakket en opvulling. Deze waarde is een geheel getal van 4.
4	4	Type	Ingesteld op een van de wettelijke waarden voor NDIS_PER_PACKET_INFO_FROM_PACKET, zoals beschreven in de Windows 2000 Driver Development Kit (DDK).
8	4	PerPacketInformationOffset	De byte-offset van het begin van deze gegevensrecord per pakket tot het begin van de gegevensgegevens per pakket.
(N)	...	Per-Packet gegevens	Per-Packet gegevens; raadpleeg de documentatie voor Windows 2000 DDK voor meer informatie.

Opmerking (N) is gelijk aan de waarde van PerPacketInformationOffset.

Opmerkingen

Elke REMOTE_NDIS_PACKET_MSG kan een of meer OOB-gegevensrecords bevatten. NumOOBDataElements geeft het aantal OOB-gegevensrecords in dit bericht aan. De OOB-gegevensrecords moeten op volgorde worden weergegeven. Het veld OOBDataLength geeft de lengte aan in bytes van het hele OOB-gegevensblok. Het veld OOBDataOffset geeft de byte-verschuiving aan van het begin van het veld DataOffset tot het begin van het OOB-gegevensblok. Zie de NDIS-specificatie in de Windows 2000 DDK voor meer informatie over OOB-pakketgegevens.

Als er meerdere OOB-gegevensblokken zijn gekoppeld aan een REMOTE_NDIS_PACKET_MSG bericht, moet elke volgende OOB-gegevensrecord onmiddellijk de gegevens van de vorige OOB-record volgen.

Er zijn momenteel geen OOB-gegevens gedefinieerd voor 802.3-apparaten.

Elke REMOTE_NDIS_PACKET_MSG kan een of meer gegevensrecords per pakket bevatten. Informatie per pakket wordt gebruikt om pakketmetagegevens over te brengen, zoals TCP-controlesom. Het veld PerPacketInfoOffset geeft de byte-verschuiving aan van het begin van het veld DataOffset tot het begin van de gegevensrecord per pakket. Het veld OOBDataLength geeft de bytelengte van de gegevensrecord per pakket aan. Zie de Windows 2000 DDK voor meer informatie over gegevens per pakket.

Als er meerdere gegevensblokken per pakket zijn, moet elke volgende gegevensrecord per pakket onmiddellijk volgen op de gegevens van de vorige gegevensrecord per pakket.

Een Extern NDIS-apparaat moet gegevens verzenden en ontvangen via NDIS-gegevenspakketten. De bus die door het apparaat wordt gebruikt, bepaalt hoe deze pakketten worden doorgegeven van host naar apparaat en apparaat om te hosten. Het kan gedeeld geheugen zijn of, in het geval van USB-, Isoch- en Bulk-pijpen. NDIS-pakketten kunnen ook out-of-band-gegevens (OOB) bevatten, evenals de gegevens die via het netwerk worden verzonden.

Een extern NDIS-apparaat draagt NDIS-pakketten over, ingekapseld als REMOTE_NDIS_PACKET_MSG in het gegevenskanaal. Zowel verbindingsloze apparaten (zoals 802.3) als verbindingsgeoriënteerde apparaten (zoals ATM) gebruiken dezelfde pakketberichtstructuur om algemene code voor pakketverwerking te vergemakkelijken. Elk REMOTE_NDIS_PACKET_MSG bericht bevat informatie over één netwerkgegevenseenheid (zoals een Ethernet 802.3-frame).

Zie de secties Windows 2000 DDK NDIS voor meer informatie over out-of-band-pakketgegevens of gegevens per pakket.

Eisen

Versie	Beschikbaar in Microsoft Windows XP en latere versies van de Windows-besturingssystemen. Ook beschikbaar in Windows 2000 als herdistribueerbare binaire bestanden.
Rubriek	Rndis.h (inclusief Rndis.h)