Функция SerCxInitialize (sercx.h)

Метод SerCxInitialize завершает инициализацию расширения последовательной платформы (SerCx) после создания связанного объекта устройства.

Синтаксис

NTSTATUS SerCxInitialize(
  [in] WDFDEVICE     FxDevice,
  [in] PSERCX_CONFIG Config
);

Параметры

[in] FxDevice

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

[in] Config

Указатель на выделенную вызывающим SERCX_CONFIG структуру, содержащую сведения о конфигурации для SerCx. Вызывающий объект ранее вызвал функцию SERCX_CONFIG_INIT для инициализации этой структуры.

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

SerCxInitialize возвращает STATUS_SUCCESS в случае успешного выполнения. Возможные значения возвращаемых ошибок включают следующие коды состояния.

Возвращаемый код Описание
STATUS_INVALID_DEVICE_REQUEST
 Метод был вызван в неправильном IRQL; или дескриптор WDFDEVICE недействителен; или FxDevice или Config имеет значение NULL.
STATUS_INSUFFICIENT_RESOURCES
 Не удалось выделить системные ресурсы (обычно память).

Замечания

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

SerCxInitialize регистрирует функции обратного вызова драйвера контроллера в SerCx. Кроме того, этот метод определяет режим передачи для очереди ввода-вывода. Во время вызова этот метод создает все внутренние структуры, необходимые SerCx (включая очередь ввода-вывода для последовательного контроллера). После возврата этого метода SerCx будет готов к обработке ввода-вывода. Однако драйвер контроллера может настроить параметры оборудования контроллера перед возвратом из EvtDriverDeviceAdd обратного вызова или перед добавлением PDO в дочерний список.

Если параметры недопустимы (как описано в SERCX_CONFIG), средство проверки драйверов вызовет ошибку.

Эта подпрограмма должна вызываться перед фиксацией устройства (возврат из EvtDriverDeviceAdd или добавление PDO в дочерний список).

Требования

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

См. также

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT

  • Last updated on