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

Статья
10/30/2024

Функция обратного вызова событий EvtSerCx2FileOpen вызывается версией 2 расширения последовательной платформы (SerCx2), чтобы уведомить драйвер последовательного контроллера о том, что клиент открыл логическое подключение к устройству последовательного контроллера и что файловый объект был создан для представления этого подключения.

Синтаксис

EVT_SERCX2_FILEOPEN EvtSercx2Fileopen;

NTSTATUS EvtSercx2Fileopen(
  [in] WDFDEVICE Device
)
{...}

Параметры

[in] Device

Дескриптор WDFDEVICE для объекта устройства платформы, представляющего последовательный контроллер. Драйвер последовательного контроллера создал этот объект в своей функции обратного вызова EvtDriverDeviceAdd. Дополнительные сведения см. в разделе SerCx2InitializeDevice.

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

Функция EvtSerCx2FileOp en возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код состояния ошибки.

Замечания

Драйвер последовательного контроллера может реализовать эту функцию в качестве параметра. При реализации драйвер регистрирует эту функцию в вызове метода SerCx2InitializeDevice, который завершает инициализацию объекта устройства платформы для последовательного контроллера. SerCx2 вызывает функцию EvtSerCx2FileOp en, когда драйвер клиента открывает дескриптор файла в стек драйверов последовательного контроллера.

Дополнительные сведения см. в разделе Объектов файлов платформы.

Примеры

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

Например, чтобы определить функцию обратного вызова EvtSerCx2FileOpen, которая называется MyFileOpen, используйте тип функции EVT_SERCX2_FILEOPEN, как показано в этом примере кода:

EVT_SERCX2_FILEOPEN  MyFileOpen;

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

_Use_decl_annotations_
NTSTATUS
  MyFileOpen(
    WDFDEVICE  Device
    )
  {...}

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.1.
целевая платформа	Настольный
заголовка	sercx.h
IRQL	Вызывается в IRQL <= DISPATCH_LEVEL.

См. также

SerCx2InitializeDevice

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