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

Статья
02/29/2024

Подпрограмма обратного вызова HwStorInitializeTracing позволяет драйверу виртуального мини-порта Storport настроить трассировку и любые связанные ресурсы.

Синтаксис

HW_INITIALIZE_TRACING HwInitializeTracing;

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

Параметры

Arg1

Первый параметр, передаваемый в StorPortInitialize.

Arg2

Второй параметр, передаваемый в StorPortInitialize.

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

None

Remarks

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

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

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

Примеры

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

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

HW_INITIALIZE_TRACING MyHwInitializeTracing;

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

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

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

Требования

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

Share via