Функция 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
целевая платформа Виндоус
заголовка ucmtcpcidevice.h
библиотеки Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

См. также

WdfDeviceCreate