NDIS_PD_FREE_QUEUE Rückruffunktion (ndis.h)

Artikel
02/26/2024

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

Hinweis Sie müssen die Funktion mit dem typ NDIS_PD_FREE_QUEUE 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.

Hinweise

Der Aufrufer ist dafür verantwortlich, sicherzustellen, dass die PD-Warteschlange leer ist, bevor er diesen Aufruf ausgibt. Der Aufrufer ist auch dafür verantwortlich, alle Filter zu löschen, die auf diese Warteschlange abzielen, bevor die Warteschlange geschlossen wird.

Beispiele

Um eine NdisPDFreeQueue-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der funktion identifiziert, die Sie definieren. 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 NdisPDFreeQueue-Funktion mit dem Namen "MyPDFreeQueue" zu definieren, verwenden Sie den typ NDIS_PD_FREE_QUEUE , 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 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_FREE_QUEUE 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

Freigeben über