HW_FREE_ADAPTER_RESOURCES Rückruffunktion (storport.h)

Artikel
02/07/2025

Die HwStorFreeAdapterResources- Rückrufroutine ermöglicht dem Storport-Treiber, Ressourcen freizugeben, wenn der virtuelle Adapter entfernt wird. Dies ist die letzte Rückrufroutine für den Adapter.

Syntax

HW_FREE_ADAPTER_RESOURCES HwFreeAdapterResources;

void HwFreeAdapterResources(
  PVOID DeviceExtension
)
{...}

Parameter

DeviceExtension

Ein Zeiger auf den Speicherbereich des virtuellen Miniporttreibers pro Adapter.

Rückgabewert

Nichts

Bemerkungen

Der Name HwStorFreeAdapterResources ist Platzhaltertext für den tatsächlichen Routinenamen. Der eigentliche Prototyp dieser Routine wird in Storport.h wie folgt definiert:

typedef
VOID
(*PHW_FREE_ADAPTER_RESOURCES) (
  IN PVOID  DeviceExtension
  );

Der Porttreiber ruft die HwStorFreeAdapterResources des Storport virtual miniports bei PASSIVE_LEVEL auf.

Beispiele

Um eine HwStorFreeAdapterResources Rückruffunktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der rückruffunktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Rückruffunktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Rückruffunktionstypen 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 HwStorFreeAdapterResources Rückrufroutine zu definieren, die MyHwAdapterFreeResourcesheißt, verwenden Sie den HW_FREE_ADAPTER_RESOURCES Typ wie in diesem Codebeispiel gezeigt:

HW_FREE_ADAPTER_RESOURCES MyHwAdapterFreeResources;

Implementieren Sie dann Ihre Rückrufroutine wie folgt:

_Use_decl_annotations_
VOID
MyHwAdapterFreeResources (
  _In_ PVOID  DeviceExtension
  );
  {
      ...
  }

Der HW_FREE_ADAPTER_RESOURCES Funktionstyp ist in der Storport.h Headerdatei 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 HW_FREE_ADAPTER_RESOURCES 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 Storport-Treiber. Informationen zu Use_decl_annotationsfinden Sie unter Annotating Function Behavior.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	storport.h (include Storport.h)

Freigeben über