Função UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

Artigo
02/29/2024

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.

Retornar valor

(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 NTSTATUS apropriado.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Windows
Cabeçalho	ucmtcpciportcontroller.h
Biblioteca	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Confira também

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

Compartilhar via