UcmTcpciPortControllerStop, fonction (ucmtcpciportcontroller.h)

Indique à l’extension de classe UcmTcpciCx pour arrêter l’envoi de requêtes matérielles à l’objet du contrôleur de port.

Syntaxe

VOID UcmTcpciPortControllerStop(
  UCMTCPCIPORTCONTROLLER PortControllerObject
);

Paramètres

PortControllerObject

Gérez l’objet du contrôleur de port reçu par le pilote client lors de l’appel précédent à UcmTcpciPortControllerCreate.

Valeur de retour

Aucun

Remarques

Après avoir appelé UcmTcpciPortControllerStop, le pilote client cesse de traiter toutes les requêtes sur l’objet du contrôleur de port. Cet appel est synchrone. Il est donc garanti que l’extension de classe n’appelle pas les fonctions de rappel ou n’envoie pas de demandes après son retour. Le pilote ne doit pas appeler cette méthode au sein d’un rappel du contrôleur de port, ou alors que toutes les demandes matérielles non annulables sont en attente.

Un pilote client appelle cette méthode à partir de son implémentation de rappel EVT_WDF_DEVICE_RELEASE_HARDWARE. Après cela, il doit également appeler WdfObjectDelete, dans le cas où EVT_WDF_DEVICE_RELEASE_HARDWARE est appelé pour rééquilibrer les ressources. Si ce n’est pas le cas, le pilote fuit les objets associés à l’objet du contrôleur de port lorsqu’un rééquilibrage de ressource se produit. Le parentage du handle UCMPORTCONTROLLER au handle WDFDEVICE n’est pas suffisant, car un WDFDEVICE n’est pas supprimé dans un rééquilibrage des ressources.

Si le pilote passe à un état Dx en raison de S0-Idle, le pilote ne doit pas appeler cette méthode à partir de sa fonction de rappel EVT_WDF_DEVICE_D0_EXIT. La synchronisation avec l’état d’alimentation du pilote peut être obtenue à l’aide d’une file d’attente gérée par l’alimentation pour recevoir des demandes matérielles.

Il est sûr d’appeler UcmTcpciPortControllerStop sur un contrôleur de port qui a déjà été arrêté. Une fois cette méthode retournée, aucune autre méthode, à l’exception de UcmTcpciPortControllerStart peut être appelée sur le contrôleur de port.

Le pilote client doit appeler cette méthode s’il doit arrêter toutes les actions sur le contrôleur de port afin qu’il puisse effectuer une récupération d’erreur s’il a détecté des problèmes pendant son opération. Une fois le processus de récupération terminé, le pilote doit redémarrer le contrôleur de port.

L’arrêt du contrôleur met fin à tout contrat actif et à la connexion Type-C.

Exigences

Voir aussi

UcmTcpciPortControllerStart