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

Статья
12/15/2024

Функция обратного вызова событий EvtSerCerCxFileOpen уведомляет драйвер последовательного контроллера о том, что клиент открыл дескриптор файла на устройстве последовательного контроллера и что объект файла был создан для представления устройства.

Синтаксис

EVT_SERCX_FILEOPEN EvtSercxFileopen;

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

Параметры

[in] Device

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

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

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

Замечания

Расширение последовательной платформы (SerCx) вызывает эту функцию для подготовки оборудования последовательного контроллера для приема запросов на операции ввода-вывода. Эта функция должна настроить контроллер в состоянии, в котором он готов получать и передавать данные. Если требуются прерывания, эта функция должна включать прерывания. Кроме того, эта функция должна выделять любую память, необходимую только в течение времени существования объекта файла. Например, эта функция может выделить буфер данных прерывания.

Чтобы зарегистрировать функцию обратного вызова EvtSerCerCxFileOpen, драйвер должен вызвать метод SerCxInitialize.

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

Примеры

Тип функции для этого обратного вызова объявлен в Sercx.h, как показано ниже.

typedef NTSTATUS
  EVT_SERCX_FILEOPEN(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;

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

NTSTATUS
  MyEvtSerCxFileOpen(
    __in WDFDEVICE Device
    )
{ ... }

Дополнительные сведения о требованиях SDV для объявлений функций см. в объявлении функций с помощью типов ролей функций для драйверов KMDF.

Требования

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

См. также

SerCxInitialize

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