Share via

UcmTcpciDeviceInitialize, fonction (ucmtcpcidevice.h)

  • Article

Initialise l’extension d’infrastructure de l’interface du contrôleur de port USB Type-C (UcmTcpciCx).

Syntaxe

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

Paramètres

WdfDevice

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

Config

Pointeur vers une structure de UCMTCPCI_DEVICE_CONFIG fournie par l’appelant qui est initialisée en appelant UCMTCPCI_DEVICE_CONFIG_INIT. Cette valeur ne peut pas être NULL.

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_INFO_LENGTH_MISMATCH
 Taille non valide pour la structure pointée vers laquelle config pointe. Doit avoir la taille de UCMTCPCI_DEVICE_CONFIG.
STATUS_INVALID_DEVICE_STATE
 L’état Plug-and-Play de l’objet d’appareil framework n’est pas initialisé. Appelez UcmTcpciDeviceInitialize dans l’implémentation du pilote de EVT_WDF_DRIVER_DEVICE_ADD.

Remarques

Le pilote client doit appeler UcmTcpciDeviceInitialize dans l’implémentation du pilote de EVT_WDF_DRIVER_DEVICE_ADD. Cette méthode configure l’objet d’appareil framework et alloue les ressources requises, s’inscrit pour les événements PnP et configure les cibles d’E/S.

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 ucmtcpcidevice.h
Bibliothèque Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

Voir aussi

WdfDeviceCreate