HW_CLEANUP_TRACING Rückruffunktion (storport.h)

  • Artikel

Die HwStorCleanupTracing-Rückrufroutine ermöglicht es dem virtuellen Storport-Miniporttreiber, die Ablaufverfolgung zu beenden und alle zugehörigen Ressourcen freizugeben.

Syntax

HW_CLEANUP_TRACING HwCleanupTracing;

void HwCleanupTracing(
  PVOID Arg1
)
{...}

Parameter

Arg1

Ein Zeiger auf das Treiberobjekt.

Rückgabewert

Keine

Bemerkungen

Der Name HwStorCleanupTracing ist Platzhaltertext für den eigentlichen Routinenamen. Der eigentliche Prototyp dieser Routine wird in Storport.h wie folgt definiert:

typedef
VOID
HW_CLEANUP_TRACING (
  IN PVOID  Arg1
  );

Der Porttreiber ruft das HwStorCleanupTracing des virtuellen Storport-Miniports unter PASSIVE_LEVEL auf.

Beispiele

Um eine HwStorCleanupTracing-Rückruffunktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten Rückruffunktion angibt. Windows bietet eine Reihe von Rückruffunktionstypen für Treiber. Das Deklarieren einer Funktion mithilfe der Rückruffunktionstypen 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 Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine HwStorCleanupTracing-Rückrufroutine mit dem Namen MyHwCleanupTracing zu definieren, verwenden Sie den HW_CLEANUP_TRACING-Typ , wie in diesem Codebeispiel gezeigt:

HW_CLEANUP_TRACING MyHwCleanupTracing;

Implementieren Sie dann Ihre Rückrufroutine wie folgt:

_Use_decl_annotations_
VOID
MyHwCleanupTracing (
  _In_ PVOID  Arg1
  );
  {
      ...
  }

Der HW_CLEANUP_TRACING Funktionstyp ist in der Headerdatei Storport.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, fügen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzu. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den HW_CLEANUP_TRACING 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 Storport-Treiber. Informationen zu Use_decl_annotations finden Sie unter Verhalten von Funktionen mit Anmerkungen.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header storport.h (einschließlich Storport.h)