функция обратного вызова HW_FREE_ADAPTER_RESOURCES (storport.h)

Статья
08/07/2023

Подпрограмма обратного вызова HwStorFreeAdapterResources позволяет драйверу виртуального мини-порта Storport освобождать ресурсы при удалении виртуального адаптера. Это последняя процедура обратного вызова для адаптера.

Синтаксис

HW_FREE_ADAPTER_RESOURCES HwFreeAdapterResources;

void HwFreeAdapterResources(
  PVOID DeviceExtension
)
{...}

Параметры

DeviceExtension

Указатель на область хранения для каждого адаптера драйвера виртуального мини-порта.

Возвращаемое значение

None

Remarks

Имя HwStorFreeAdapterResources — это замещающий текст для фактического имени подпрограммы. Фактический прототип этой подпрограммы определен в Storport.h следующим образом:

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

Драйвер порта вызывает HwStorFreeAdapterResources виртуального мини-порта Storport по PASSIVE_LEVEL.

Примеры

Чтобы определить функцию обратного вызова HwStorFreeAdapterResources , необходимо сначала предоставить объявление функции, определяющее тип определяемой функции обратного вызова. Windows предоставляет набор типов функций обратного вызова для драйверов. Объявление функции с помощью типов функций обратного вызова помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.

Например, чтобы определить подпрограмму обратного вызова HwStorFreeAdapterResources с именем MyHwAdapterFreeResources, используйте тип HW_FREE_ADAPTER_RESOURCES , как показано в следующем примере кода:

HW_FREE_ADAPTER_RESOURCES MyHwAdapterFreeResources;

Затем реализуйте процедуру обратного вызова следующим образом:

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

Тип функции HW_FREE_ADAPTER_RESOURCES определяется в файле заголовка Storport.h . Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, которые применяются к типу функции HW_FREE_ADAPTER_RESOURCES в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов Storport. Сведения о Use_decl_annotations см. в статье О поведении функции.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	storport.h (включая Storport.h)

Поделиться через