NDIS_PD_CLEAR_RECEIVE_FILTER Rückruffunktion (ndis.h)
Die PacketDirect-Plattform (PD) ruft die NdisPDClearReceiveFilter-Funktion eines PD-fähigen Miniporttreibers auf, um diesen Filter von der PD-Plattform zu löschen.
Syntax
NDIS_PD_CLEAR_RECEIVE_FILTER NdisPdClearReceiveFilter;
VOID() NdisPdClearReceiveFilter(
[in] NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}
Parameter
[in] FilterHandle
Ein Handle für einen PD-Plattformfilter.
Rückgabewert
Diese Rückruffunktion gibt keinen Wert zurück.
Hinweise
Nachdem diese Funktion zurückgegeben wurde, wird garantiert, dass kein neu eingehendes Paket mehr mit diesem Filter übereinstimmt. Es kann jedoch weiterhin Flight-Pakete geben, die bereits mit diesem Filter übereinstimmen, und sie sind auf dem Weg, in die Ziel-Empfangswarteschlange eingefügt zu werden.
Beispiele
Um eine NdisPDClearReceiveFilter-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der zu definierenden Funktion identifiziert. Windows bietet eine Reihe von Funktionstypen für Treiber. Das Deklarieren einer Funktion mithilfe der Funktionstypen hilft der Codeanalyse für Treiber, der statischen Treiberüberprüfung (Static Driver Verifier , SDV) und anderen Überprüfungstools, Fehler zu finden, und es ist eine Voraussetzung für das Schreiben von Treibern für das Windows-Betriebssystem.Um beispielsweise eine NdisPDClearReceiveFilter-Funktion mit dem Namen "MyPDClearReceiveFilter" zu definieren, verwenden Sie den typ NDIS_PD_CLEAR_RECEIVE_FILTER , wie in diesem Codebeispiel gezeigt:
NDIS_PD_CLEAR_RECEIVE_FILTER MyPDClearReceiveFilter;
Implementieren Sie dann Ihre Funktion wie folgt:
_Use_decl_annotations_
VOID
MyPDClearReceiveFilter(
NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}
Der NDIS_PD_CLEAR_RECEIVE_FILTER Funktionstyp ist in der Headerdatei Ntddndis.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, müssen Sie der Funktionsdefinition die anmerkung Use_decl_annotations hinzufügen. Die Use_decl_annotations-Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den NDIS_PD_CLEAR_RECEIVE_FILTER Funktionstyp in der Headerdatei angewendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.
Informationen zu Use_decl_annotations finden Sie unter Verhalten von Funktionen mit Anmerkungen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 10 |
Unterstützte Mindestversion (Server) | Windows Server 2016 |
Zielplattform | Windows |
Kopfzeile | ndis.h |
IRQL | PASSIVE_LEVEL |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für