NdisGetReceivedPacket-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.
NdisGetReceivedPacket ruft ein Paket ab, das vom zugrunde liegenden Treiber empfangen wurde.
Syntax
PNDIS_PACKET NdisGetReceivedPacket(
[in] NDIS_HANDLE NdisBindingHandle,
[in] NDIS_HANDLE MacContext
);
Parameter
[in] NdisBindingHandle
Gibt das Handle an, das von NdisOpenAdapter zurückgegeben wurde, das die Ziel-NIC oder den virtuellen Adapter des zugrunde liegenden Treibers identifiziert, an den der aufrufende Treiber gebunden ist.
[in] MacContext
Gibt ein Kontexthandle an, das der zugrunde liegende Treiber dem vom Netzwerk empfangenen Paket zuordnet. Dieses Handle wurde als Eingabeparameter an die ProtocolReceive-Funktion des aufrufenden Treibers übergeben. Dieser Handle ist für den aufrufenden Treiber undurchsichtig und für die Verwendung durch den zugrunde liegenden Treiber reserviert, der die Angabe gemacht hat.
Rückgabewert
Gibt einen Zeiger auf einen Paketdeskriptor zurück, der Daten enthält, die auf dem zugrunde liegenden Treiber empfangen wurden.
Bemerkungen
Mehrere Protokoll- oder Zwischentreiber können an eine einzelne zugrunde liegende NIC gebunden werden, und jeder dieser Treiber kann eine Angabe für dasselbe Paket erhalten. Ein solches Paket ist schreibgeschützt für diese Treiber. Jede ProtocolReceive-Funktion dieses Treibers bestimmt, ob NdisGetReceivedPacket- aufgerufen werden soll, um das angegebene Paket abzurufen.
- 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- | IRQL-<= DISPATCH_LEVEL |