HW_FREE_ADAPTER_RESOURCES Rückruffunktion (storport.h)

Artikel
02/29/2024

Die HwStorFreeAdapterResources-Rückrufroutine ermöglicht es dem storport virtual miniport-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

Keine

Bemerkungen

Der Name HwStorFreeAdapterResources ist Platzhaltertext für den eigentlichen 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 virtuellen Storport-Miniports unter PASSIVE_LEVEL auf.

Beispiele

Um eine HwStorFreeAdapterResources-Rückruffunktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten Rückruffunktion identifiziert. 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 HwStorFreeAdapterResources-Rückrufroutine mit dem Namen MyHwAdapterFreeResources zu definieren, 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 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_FREE_ADAPTER_RESOURCES 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