Функция 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
Недопустимый размер структуры, на которую указывают возможности конфигурации или конфигурации >. Должен быть размером 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