NDIS_PD_FREE_QUEUE Rückruffunktion (ndis.h)

Artikel
02/07/2025

Die PacketDirect(PD)-Plattform ruft die NdisPDFreeQueue Funktion eines PD-fähigen Miniporttreibers auf, um eine Warteschlange freizulösen.

Hinweis Sie müssen die Funktion mithilfe des NDIS_PD_FREE_QUEUE-Typs deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".

Syntax

NDIS_PD_FREE_QUEUE NdisPdFreeQueue;

VOID() NdisPdFreeQueue(
  [in] NDIS_PD_QUEUE *NdisPDQueue
)
{...}

Parameter

[in] NdisPDQueue

Jede leere Warteschlange, die aus dem Arbeitsspeicher freigegeben werden muss. Weitere Informationen finden Sie in der NDIS_PD_QUEUE Struktur.

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

Bemerkungen

Der Anrufer ist dafür verantwortlich, sicherzustellen, dass die PD-Warteschlange leer ist, bevor sie diesen Anruf ausstellen. Der Anrufer ist auch dafür verantwortlich, alle Filter zu löschen, die auf diese Warteschlange abzielen, bevor die Warteschlange geschlossen wird.

beispiele für

Um eine NdisPDFreeQueue--Funktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der Funktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Funktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine NdisPDFreeQueue Funktion zu definieren, die den Namen "MyPDFreeQueue" hat, verwenden Sie den NDIS_PD_FREE_QUEUE Typ, wie in diesem Codebeispiel gezeigt:

NDIS_PD_FREE_QUEUE MyPDFreeQueue;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyPDFreeQueue(
    NDIS_PD_QUEUE*  NdisPDQueue
    )
  {...}

Der NDIS_PD_FREE_QUEUE Funktionstyp wird in der Headerdatei "Ntddndis.h" definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den Funktionstyp NDIS_PD_FREE_QUEUE in der Headerdatei angewendet werden, verwendet 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_annotationsfinden Sie unter Annotating Function Behavior.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	ndis.h
IRQL-	PASSIVE_LEVEL

Freigeben über