Функция UcmTcpciDeviceInitialize (ucmtcpcidevice.h)

  • Статья

Инициализирует расширение платформы интерфейса контроллера портов USB Type-C (UcmTcpciCx).

Синтаксис

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

Параметры

WdfDevice

Дескриптор объекта устройства платформы, который драйвер клиента получил в предыдущем вызове WdfDeviceCreate.

Config

Указатель на структуру, предоставляемую вызывающим UCMTCPCI_DEVICE_CONFIG , которая инициализирована путем вызова UCMTCPCI_DEVICE_CONFIG_INIT. Это значение не может иметь значение NULL.

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

(NTSTATUS) Метод возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть соответствующий код ошибки NTSTATUS .

Код возврата Описание
STATUS_INFO_LENGTH_MISMATCH
 Недопустимый размер структуры, на которую указывает Config. Должен иметь размер UCMTCPCI_DEVICE_CONFIG.
STATUS_INVALID_DEVICE_STATE
 Состояние Plug and Play объекта устройства платформы не инициализировано. Вызовите UcmTcpciDeviceInitialize в реализации драйвера EVT_WDF_DRIVER_DEVICE_ADD.

Комментарии

Драйвер клиента должен вызывать UcmTcpciDeviceInitialize в реализации драйвера EVT_WDF_DRIVER_DEVICE_ADD. Этот метод настраивает объект устройства платформы и выделяет необходимые ресурсы, регистрирует события PnP и настраивает целевые объекты ввода-вывода.

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Header ucmtcpcidevice.h
Библиотека Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

См. также раздел

WdfDeviceCreate