Função UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

Artigo
02/07/2025

Cria um objeto de controlador de porta para registrar com UcmTcpciCx.

Sintaxe

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

Parâmetros

WdfDevice

Um identificador para um objeto de dispositivo de estrutura que o driver cliente recebeu na chamada anterior para WdfDeviceCreate.

Config

Um ponteiro para o UCMTCPCI_PORT_CONTROLLER_CONFIG inicializado chamando UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT. Esse valor não pode ser NULL.

Attributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos fornecidos pelo driver para o novo objeto. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

PortControllerObject

Um ponteiro para um local que recebe um identificador para o novo objeto do controlador de porta.

Valor de retorno

(NTSTATUS) O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um código de erro de NTSTATUS apropriado.

Código de retorno	Descrição
STATUS_INVALID_DEVICE_REQUEST	O identificador de um objeto de dispositivo de estrutura é inválido.
STATUS_INFO_LENGTH_MISMATCH	Tamanho inválido para a estrutura apontada por de Configuração ou Config->Capabilities. Deve ter o tamanho de UCMTCPCI_PORT_CONTROLLER_CONFIG ou UCMTCPCI_PORT_CONTROLLER_CAPABILITIES, respectivamente.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	ucmtcpciportcontroller.h
biblioteca	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Consulte também

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

Partilhar via