HW_INITIALIZE_TRACING Rückruffunktion (storport.h)

Artikel
02/29/2024

Die HwStorInitializeTracing-Rückrufroutine ermöglicht es dem storport virtual miniport-Treiber, die Ablaufverfolgung und alle zugehörigen Ressourcen einzurichten.

Syntax

HW_INITIALIZE_TRACING HwInitializeTracing;

void HwInitializeTracing(
  PVOID Arg1,
  PVOID Arg2
)
{...}

Parameter

Arg1

Der erste Parameter, der an StorPortInitialize übergeben wird.

Arg2

Der zweite Parameter, der an StorPortInitialize übergeben wird.

Rückgabewert

Keine

Bemerkungen

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

typedef
VOID
HW_INITIALIZE_TRACING (
  _In_ PVOID  Arg1,
  _In_ PVOID  Arg2
  );

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

Beispiele

Um eine HwStorInitializeTracing-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 HwStorInitializeTracing-Rückrufroutine mit dem Namen MyHwInitializeTracing zu definieren, verwenden Sie den typ HW_INITIALIZE_TRACING , wie in diesem Codebeispiel gezeigt:

HW_INITIALIZE_TRACING MyHwInitializeTracing;

Implementieren Sie dann Ihre Rückrufroutine wie folgt:

_Use_decl_annotations_
VOID
MyHwInitializeTracing (
  _In_ PVOID  Arg1,
  _In_ PVOID  Arg2
  );
  {
      ...
  }

Der HW_INITIALIZE_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_INITIALIZE_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)

Freigeben über