Función UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

Artículo
08/07/2023

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 mediante una llamada a UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT. Este valor no puede ser NULL.

Attributes

Puntero a una estructura 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	Value
Cliente mínimo compatible	Windows 10
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Windows
Encabezado	ucmtcpciportcontroller.h
Library	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Consulte también

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

Share via