UcmTcpciPortControllerCreate, fonction (ucmtcpciportcontroller.h)

  • Article

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 d’un objet d’appareil d’infrastructure que le pilote client a reçu 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 contrôleur de port.

Valeur retournée

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

Code de retour Description
STATUS_INVALID_DEVICE_REQUEST
 Le handle d’un objet d’appareil framework n’est pas valide.
STATUS_INFO_LENGTH_MISMATCH
 Taille non valide pour la structure pointée par Config ou Config->Capabilities. La taille doit être UCMTCPCI_PORT_CONTROLLER_CONFIG ou UCMTCPCI_PORT_CONTROLLER_CAPABILITIES, respectivement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête ucmtcpciportcontroller.h
Bibliothèque Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

Voir aussi

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate