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

Статья
02/29/2024

Создает объект контроллера порта для регистрации в 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

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