UcmTcpciPortControllerCreate, fonction (ucmtcpciportcontroller.h)

Article
02/07/2025

Crée un objet de contrôleur de port à inscrire auprès d’UcmTcpciCx.

Syntaxe

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

Paramètres

WdfDevice

Handle vers un objet d’appareil framework reçu par le pilote client lors de l’appel précédent à WdfDeviceCreate.

Config

Pointeur vers le UCMTCPCI_PORT_CONTROLLER_CONFIG initialisé en appelant UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT. Cette valeur ne peut pas être NULL.

Attributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES qui contient des attributs fournis par le pilote pour le nouvel objet. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

PortControllerObject

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet de contrôleur de port.

Valeur de retour

(NTSTATUS) La méthode retourne STATUS_SUCCESS si l’opération réussit. Dans le cas contraire, cette méthode peut retourner un code d’erreur NTSTATUS approprié.

Retourner le code	Description
STATUS_INVALID_DEVICE_REQUEST	Le handle d’un objet d’appareil framework n’est pas valide.
STATUS_INFO_LENGTH_MISMATCH	Taille non valide de la structure pointée par configuration ou Fonctionnalités de configuration>. Doit être de taille de UCMTCPCI_PORT_CONTROLLER_CONFIG ou de UCMTCPCI_PORT_CONTROLLER_CAPABILITIES, respectivement.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
d’en-tête	ucmtcpciportcontroller.h
bibliothèque	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Voir aussi

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

Partager via