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

Статья
02/07/2025

Создает объект контроллера порта для регистрации в 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->Возможности. Должен быть размером UCMTCPCI_PORT_CONTROLLER_CONFIG или UCMTCPCI_PORT_CONTROLLER_CAPABILITIESсоответственно.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	ucmtcpciportcontroller.h
библиотеки	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

См. также

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

Поделиться через