Función UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

Crea un objeto de controlador de puerto para registrarse con UcmTcpciCx.

Sintaxis

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

Parámetros

WdfDevice

Identificador de un objeto de dispositivo de marco que el controlador cliente recibió en la llamada anterior a WdfDeviceCreate.

Config

Puntero al UCMTCPCI_PORT_CONTROLLER_CONFIG que se inicializa llamando a UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT. Este valor no puede ser NULL.

Attributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES que contiene atributos proporcionados por el controlador para el nuevo objeto. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.

PortControllerObject

Puntero a una ubicación que recibe un identificador para el nuevo objeto de controlador de puerto.

Valor devuelto

(NTSTATUS) El método devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver un código de error NTSTATUS adecuado.

Código devuelto	Descripción
STATUS_INVALID_DEVICE_REQUEST	El identificador de un objeto de dispositivo de marco no es válido.
STATUS_INFO_LENGTH_MISMATCH	Tamaño no válido para la estructura a la que apunta config o Config->Capabilities. Debe ser el tamaño de UCMTCPCI_PORT_CONTROLLER_CONFIG o UCMTCPCI_PORT_CONTROLLER_CAPABILITIES, respectivamente.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
encabezado de	ucmtcpciportcontroller.h
biblioteca de	Ucmtcpcicxstub.lib
irQL	PASSIVE_LEVEL

Consulte también

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCrear