Функция UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

  • Статья

Создает объект контроллера порта для регистрации в UcmTcpciCx.

Синтаксис

NTSTATUS UcmTcpciPortControllerCreate(
  WDFDEVICE                        WdfDevice,
  PUCMTCPCI_PORT_CONTROLLER_CONFIG Config,
  PWDF_OBJECT_ATTRIBUTES           Attributes,
  UCMTCPCIPORTCONTROLLER           *PortControllerObject
);

Параметры

WdfDevice

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

Config

Указатель на UCMTCPCI_PORT_CONTROLLER_CONFIG , инициализируемый путем вызова UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT. Это значение не может иметь значение NULL.

Attributes

Указатель на структуру WDF_OBJECT_ATTRIBUTES , которая содержит предоставленные драйвером атрибуты для нового объекта. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

PortControllerObject

Указатель на расположение, которое получает дескриптор нового объекта контроллера порта.

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

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

Код возврата Описание
STATUS_INVALID_DEVICE_REQUEST
 Дескриптор объекта устройства платформы недопустим.
STATUS_INFO_LENGTH_MISMATCH
 Недопустимый размер структуры, на которую указывает Config или Config->Capabilities. Должен иметь размер UCMTCPCI_PORT_CONTROLLER_CONFIG или UCMTCPCI_PORT_CONTROLLER_CAPABILITIES соответственно.

Требования

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

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

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate